Skip to main content
POST
/
customer_identities
/
create_or_update
Create or update a customer identity
curl --request POST \
  --url https://api.smile.io/v1/customer_identities/create_or_update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_identity": {
    "email": "jane@doe.com",
    "distinct_id": "cust_19238475",
    "first_name": "Jane",
    "last_name": "Doe",
    "properties": {}
  }
}
'
{
  "customer_identity": {
    "id": 863291377,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@doe.com",
    "distinct_id": "cust_19238475",
    "properties": {},
    "customer_id": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://dev.smile.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint requires the scope.
This endpoint is only available to apps making calls using an OAuth token. Attempting to use this endpoint with an API key will fail.
Creating: If no customer identity exists with the provided distinct_id, a new customer identity is created.
  • If the provided email matches an existing customer record, the customer identity is linked to that customer.
  • If the provided email does not match an existing customer record, a new customer is created and a customer identity is linked to the new customer.
Updating: If a customer identity exists with the provided distinct_id, it is updated with any new information provided in the request.
  • No changes to the linked customer record will occur.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
customer_identity
object
required

Response

Customer identity successfully updated.

​
customer_identity
object