Skip to main content
POST
/
api
/
v1
/
contacts
/
Create Contact
curl --request POST \
  --url https://api.ravan.ai/api/v1/contacts/ \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "company": "<string>",
  "metadata": {}
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "id": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "company": "<string>",
    "metadata": {},
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header. Find or rotate it from your Ravan AI account settings.

​
Body

​
first_name
string
The contact first name.
​
last_name
string
The contact last name.
​
email
string
The contact email address. Use a valid email format such as alex@example.com.
​
phone
string
The contact phone number in E.164 format. Example: +14157774444.
​
company
string
The contact company or organization name.
​
metadata
object
Custom key-value data to attach to the resource. Use this for IDs or attributes from your own systems.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Returned data.

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
first_name
string

First name

​
last_name
string

Last name

​
email
string

Email address

​
phone
string

Phone number

​
company
string

Company name

​
metadata
object

Custom metadata

Response

200 - application/json

Successful response

​
success
boolean
​
message
string
​
data
object