Members - Register


POST /v1.1/member/register


Accepts authentication credentials and associated user data to 'register' a member with AE. Returns information about newly created or existing member

required *

apiKey *  string Your API access key
service *  string service identifier - email, twitter, facebook, google, instagram, lastfm, youtube, spotify, tumblr, soundcloud, foursquare, deezer
authtoken  string primary token returned by authorizing service. Required for social network registrations
uid  string unique id of user on the service in question eg. Spotify User ID, Twitter ID. Required for social network registrations.
authsecret  string authentication secret or refresh token returned by some authorizing services. Refresh token may be required to maintain social listening.
firstname  string firstname from authorizing services if available
surname  string lastname authorizing services if available
username  string username from authorizing services if available
email  string email address from authorizing services. Required for email registration.
password  string Required for email registration.
birthdate  string date of birth from authorizing services if available (dd-mm-yyyy)
gender  string values: M, F, Other
city  string City of member
country  string Country of member in alpha-2 code. eg. US, CA, GB, etc
region  string Region with country for member. eg state or province
postcode  string Postal code of member
partner  string a partner id provided by you - eg external id for member, etc
code  string a consistent import code provided by you - eg 'external_system_a'
sourceuid  string external id used by partner
domain  string website to associate registration with
ip  string IP address to associate registration with
useragent  string The user agent string for the visiting user browser. Will identify device type for analytics.
segmentid  integer The ID of an existing segment to include the registering member in.
activity_sharing_enabled  inetger 1 => enabled, 0 => disabled. Default is 1
id  integer The ID of an existing user. Will attach new service to user or update existing service data. Use the endpoint format /member/[memberid]/register

Sign in with your developer account to use the console, or sign up here

Example Request

curl -X POST ""
$curl = curl_init();

curl_setopt_array($curl, array( 
	CURLOPT_URL => "", 

$response = curl_exec($curl);

echo $response;
import requests

url = ""

headers = {}
payload = {}

response = requests.request("POST", url, headers=headers, data=payload)

var request = require('request');
var options = {
	'method': 'POST',
	'url': '',
	'headers': {}
request(options, function (error, response) {
	if (error) throw new Error(error);

Example Response

"data": {
"ID": 1234, "Email": "",
"FirstName": "Jean Luc",
"Surname": "Picard",
"Country": "",
"City": null, "State": null, "PostCode": null, "Gender": "M",
"Username": "JLP",
"AccessToken": "0345481636hbjvhf2_1588732857",
"AvatarURL": "",
"CountryCode": "",
"GeoCountry": null, "VerifiedEmail": ""
}, "optins": [], "services": [ {
"Service": "spotify",
"Valid": "1",
"ActivitySharing": "1",
"ID": "33333",
"UserID": "1111",
"Username": "JLP",
"UserURL": null, "Token": "asdf",
"TokenSecret": "asdfasdf",
"LastUpdated": null, "LastLogin": "2358-05-05 16:00:00",
"VerifiedEmail": "",
"PaidAccount": "0",
"Followers": "1",
"Likes": "0",
"PartnerCode": null, "PartnerID": null, "Domains": [ "API" ]
} ], "jwt": "eyJhbGciOiJSUzI1NiIsInR5cCI6boT4UTTHJXbnE28MW5lUzuU5WwKaowaLyTdesQ"