POST
/
api
/
v1
/
contacts
curl -X POST https://api.ravan.ai/api/v1/contacts/ \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp"}'

{
  "success": true, "message": "Contact created successfully",
  "data": { "id": "019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b", "first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp", "created_at": "2026-03-20T14:30:00Z" }
}

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key.

​
Body

​
first_name
string
Contact’s first name.
​
last_name
string
Contact’s last name.
​
email
string
Contact’s email address.
​
phone
string
Phone number in E.164 format.
​
company
string
Company or organization name.
​
metadata
object
Optional key-value metadata.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
The created contact record.
curl -X POST https://api.ravan.ai/api/v1/contacts/ \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp"}'

{
  "success": true, "message": "Contact created successfully",
  "data": { "id": "019d3a2b-5c6d-7e8f-9a0b-1c2d3e4f5a6b", "first_name": "John", "last_name": "Smith", "email": "john@example.com", "phone": "+14155550100", "company": "Acme Corp", "created_at": "2026-03-20T14:30:00Z" }
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
first_name
string
​
last_name
string
​
email
string
​
phone
string
​
company
string
​
metadata
object

Response

Successful response

​
success
boolean
​
message
string
​
data
object