Create contact
POST
https://app.sendapp.ai/api/contacts
Create (or upsert) a single contact. It must have at least a phone OR an email. Existing contacts with the same phone/email are merged (tags combined, metadata merged).
Responses:
201 Created with the created contact — 403 if the plan's contact limit is reached — 422 if both phone and email are missing.You can write custom fields right when creating the contact with
custom_fields, by name, with the same rules as Update contact: an unknown name or an invalid value returns 422 and the contact is not saved. If the contact already exists, the values sent replace the saved ones and empty values are ignored. You find the field names with GET /api/contact-fields.Parameters
9 · 3 required
apikey
required
Your API Key (the
X-API-Key header also works).
name
optional
Full name, up to 255 characters.
first_name
optional
First name. With
first_name and/or last_name the full name is built from them (they take precedence over name).
last_name
optional
Last name.
phone
required
International format (e.g. +393391234567). Required if email is missing.
email
required
Valid email. Required if phone is missing.
tags
optional
Array of strings or comma-separated string (e.g. "vip,newsletter").
metadata
optional
JSON object with custom fields.
custom_fields
optional
Object keyed by custom field NAME, e.g.
{"City": "Rome", "Newsletter": true}. Each value is checked against the field's type, as in Update contact.
Need help with the integration? info@sendapp.live