Skip to main content
POST
/
v1
/
contacts
Create Contact
curl --request POST \
  --url https://api.stover.app/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "company": "<string>",
  "notes": "<string>",
  "utm_source": "<string>",
  "utm_medium": "<string>",
  "utm_campaign": "<string>",
  "referral_url": "<string>"
}
'
{
  "success": true,
  "data": {}
}

Documentation Index

Fetch the complete documentation index at: https://developers.stover.app/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint supports both authenticated and public modes. Omit the API key for lead capture forms (rate limited to 20 req/min per IP).

​
Request Fields

FieldRequiredDescription
first_nameYesFirst name
last_nameYesLast name
email*Email address
phone*Phone number
companyNoCompany name
notesNoAdditional notes
utm_sourceNoTraffic source
utm_mediumNoMarketing medium
utm_campaignNoCampaign name
referral_urlNoReferral page URL
* At least one of email or phone is required.

​
Example

curl -X POST https://api.stover.app/v1/contacts \
  -H "Authorization: Bearer stover_pk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "[email protected]",
    "company": "Acme Inc",
    "utm_source": "linkedin"
  }'

Authorizations

​
Authorization
string
header
required

API key: Bearer stover_pk_...

Body

application/json
​
first_name
string
required

First name

​
last_name
string
required

Last name

​
email
string

Email (required if no phone)

​
phone
string

Phone (required if no email)

​
company
string
​
notes
string
​
utm_source
string
​
utm_medium
string
​
utm_campaign
string
​
referral_url
string

Response

Contact created

​
success
boolean
​
data
object