Contactsv2

Create a contact

POST/contacts

Create a new contact with a phone number (E.164 format) or email address.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON

identifierRequiredstring

Phone number (E.164 format, e.g., +15551234567) or email address

nameoptionalstring

Display name for the contact

Returns

idoptionalstring

Contact identifier (phone or email)

contact_idoptionalstring

Internal contact ID

identifieroptionalstring

Phone number (E.164) or email

nameoptionalstring | null

typeoptionalstring

"phone""email"

created_atoptionalinteger

last_message_timeoptionalinteger | null

tagsoptionalstring[]

Response codes

201Contact created

400Invalid request parameters

401Authentication required or invalid

409Contact already exists

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X POST https://api.blooio.com/v2/api/contacts \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "identifier": "+15551234567",    "name": "John Doe"  }'

Body object

{  "identifier": "+15551234567",  "name": "John Doe"}

Response objectexample

{  "id": "ct_a1b2c3d4",  "contact_id": "ct_a1b2c3d4",  "identifier": "+15551234567",  "name": "Jane Doe",  "type": "phone",  "created_at": 0,  "last_message_time": 0,  "tags": [    "string"  ]}