Upsert contact

Creates a new contact or updates an existing one based on the phone number.

Use Case: Use this endpoint to synchronize your customer data with Wax CRM. This is useful for:

  • Importing contacts from your e-commerce platform, CRM, or other systems
  • Updating contact information when customers update their profile
  • Adding custom attributes to contacts for segmentation and personalization

Technical Details:

  • If a contact with the given phone number exists, it will be updated with the provided data
  • If no contact exists, a new one will be created
  • Custom attributes are upserted (created or updated) individually
  • Tags are added to the contact (existing tags are preserved)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The contact phone number in E.164 format. Required if email is not provided.

string

The contact email address. Required if phone_number is not provided.

string

The contact first name.

string

The contact last name.

attributes
object

Custom contact attributes that will be stored in the CRM. Attribute will be created if they do not exist.

tags
array of strings

An array of tag names to assign to the contact. Tags will be created if they do not exist.

tags
Headers
string
required

Bearer token

Responses
200

successful

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json