.. meta::
    :description: This documentation will guide you through the use of the Memset API.

.. index::
   double: Methods; partner.account

.. _partner.account:

Partner Account Methods
-----------------------



.. function:: partner.account.create

    Creates a new Memset account which will be associated with the calling partner.
    
    :param user_email: Email address of the end user. Must be a valid email address.
    :type user_email: String
    
    :param user_title: Title of the end user. Acceptable values
        
        'Mr'
            Mr
        'Mrs'
            Mrs
        'Ms'
            Ms
        'Miss'
            Miss
        'Dr'
            Dr
        'Rev'
            Rev
        
    :type user_title: String
    
    :param user_forename: Forename of the end user. Ensure this value has at most 50 characters.
    :type user_forename: String
    
    :param user_surname: Surname of the end user. Ensure this value has at most 50 characters.
    :type user_surname: String
    
    :param user_company: Company of the end user. Ensure this value has at most 200 characters.
    :type user_company: String, Optional
    
    :param user_phone: Phone number of the end user.  Ensure this value has at most 50 characters.
    :type user_phone: String
    
    :param user_address: Address of end user. Ensure this value has at most 250 characters.
    :type user_address: String
    
    :param user_town: Town of end user. Ensure this value has at most 100 characters.
    :type user_town: String
    
    :param user_statecounty: State/county of end user. Ensure this value has at most 100 characters.
    :type user_statecounty: String
    
    :param user_country: ISO 3166-1 alpha-2 code for the country of the end user. Ensure this value has at most 2 characters.
    :type user_country: String
    
    :param user_postcode: Postal code for the address of the end user. Ensure this value has at most 20 characters.
    :type user_postcode: String
    
    :param account_currency: Currency to use for billing on the new account, defaults to 'GBP'. Acceptable values
        
        'GBP'
            GBP
        'EUR'
            EUR
        'USD'
            USD
        
    :type account_currency: String, Optional
    
    :returns: A dictionary with the following keys
    
        **account**
            the name of the account generated
        **api_key**
            information about a key used to manage the account, same format as :func:`apikey.info`

.. function:: partner.account.list

    Returns a list of account names which are associated with the calling partner.
    
    
    :returns: A list of strings which are the names of accounts associated with the calling partner.