post https://example-client-domain.extole.io/api/v4/me?access_token=
Calling this endpoint allows the user to update the profile associated with the token passed into the request. If the user's email does not yet exist in our system, calling this endpoint will create a new profile. Please note that this call can only be made once per token. Subsequent attempts to update the token with a new profile will result in a 400 error.
Response Data Fields
| Field | Description |
|---|---|
id(string) | Extole's unique identifier for the customer. |
email(string) | The customer's unique email address. |
partner_user_id(string) | A unique identifier of the customer provided by you, such as a "user ID", "customer ID", etc. |
first_name(string) | The customer's first name. This is used for personalization of share messages, reporting, and customer support. |
last_name(string) | The customer's last name. This is used for personalization of share messages, reporting, and customer support. |
profile_picture_url(string) | A URL to the customer's profile picture. |
parameters(object) | A map of key/value parameters associated with this customer's profile. Parameters may be "public," in which case they can be retrieved with an unverified token, or "private," which requires a verified token. |
Error Responses
| Error Code | Description |
|---|---|
400 FIRST_NAME_INVALID_LENGTH | First name length greater than 50 characters. |
400 INVALID_PERSON_EMAIL | Invalid person email. |
400 LAST_NAME_INVALID_LENGTH | Last name length greater than 50 characters. |
400 PARTNER_USER_ID_ALREADY_DEFINED | Partner user ID already defined. |
400 PARTNER_USER_ID_INVALID_LENGTH | Partner user ID length greater than 255 characters. |
400 PERSON_EMAIL_ALREADY_DEFINED | Person email already defined. |
400 PERSON_NOT_FOUND | Person not found. |
400 PROFILE_PICTURE_URL | Malformed profile_picture_url. |
403 ACCESS_DENIED | The access_token provided is not permitted to access the specified resource. |
403 ACCESS_TOKEN_EXPIRED | The access_token provided with this request has expired. |
403 ACCESS_TOKEN_INVALID | The access_token provided with this request is invalid. |
403 ACCESS_TOKEN_MISSING | Missing access_token. |