Create your first contact

Use a number you control for any later channel tests. The synthetic value below illustrates the request shape.

Before you begin

Configure your API host and key and use an organization where you can create test records.

Create a contact

Send the request below with your test contact’s number.

curl -X POST "$GOMOBILE_API_BASE_URL/contact" \
  -H "X-API-Key: $GOMOBILE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"primaryPhone":"+212600000000","firstName":"Sara","lastName":"Test","city":"Casablanca"}'

Keep the returned ID

A successful creation returns HTTP 201. Save response.contact.id as CONTACT_ID. Inspect attributeErrors: successful creation does not mean every custom attribute was stored.

Retrieve the record

curl "$GOMOBILE_API_BASE_URL/contact/$CONTACT_ID" \
  -H "X-API-Key: $GOMOBILE_API_KEY"

Expected result

The retrieved record contains your test data. Creating a contact does not send a message or place a call.

Troubleshooting

For validation failures, send only documented fields. If the number already exists, inspect the existing contact rather than repeatedly creating it. See the Contacts API for update and upsert operations. Next: create an audience.

Quickstarts

Guides

Before you begin

Expected result

Troubleshooting

​Before you begin

​Expected result

​Troubleshooting

Before you begin

Expected result

Troubleshooting