Use this endpoint to programmatically merge two duplicate customers, effectively unifying them as one. You can choose to use this end-point to:

  1. Merge 2 customers with different customer_ids

  2. Update the customer_id of an existing customer in Blueshift

Attribute Description
`email` or `customer_id` or both Previous/current unique identifier for the customer in Blueshift.
`bsft_new_customer_id` The `customer_id` of the target customer.

The Merge customers endpoint is throttled at 1500 calls/minute. Reach out to [email protected] if you want to increase the rate limits or if you have any questions. To try this endpoint:

  1. Get the User API Key from the API Keys tab of your Account Settings in the Blueshift app.

  2. Paste the API key in the username field for Authentication. Leave the password field blank.

  3. Click the Base URL dropdown and select the API endpoint URL for your Blueshift region. For EU region select and for the Rest of the world select

  4. Specify the values of the API call using the fields provided below. Ensure that you specify values for the required fields.

  5. Click Try It.


  1. If no customers are present in our platform with either a combination of email/customer_id or bsft_new_customer_id; we will create a new user with bsft_new_customer_id.

  2. If both customers exist, the profile data of the old customers will get merged to the new customer (bsft_new_customer_id).

  3. If there are multiple customer profile matches, for example if you provide an email and there are multiple customers associated with that email, we will only update the most recent customer profile. In such cases, we recommend you to use the customer_id if you have multiple profiles on an email address.

  4. If a customer exists with an email/customer_id, but no customer exists with bsft_new_customer_id; we will update the customer_id of the existing customer to bsft_new_customer_id.

Click Try It! to start a request and see the response here!