Skip to main content

List Contacts

Retrieve a list of contacts for the authenticated business.
schema
string
required
Schema identifier. Must be contacts
page
number
Page number for pagination
limit
number
Number of records per page
Search term
date_order
string
Order records by creation date. Values: asc (oldest first) or desc (newest first). Default: desc
curl -X GET "https://api.useadam.io/v1/adam/contacts?schema=contacts&page=1&limit=20" \
  -H "X-API-Key: your_secret_key"

Get Contact

Retrieve a specific contact by UUID.
uuid
string
required
Contact UUID

Create Contact

Create a new contact using AI prompt.
prompt
string
required
Description of the contact to create
attachments
array
Array of attachment URLs or file references
text_attachment
string
Additional text context
curl -X POST "https://api.useadam.io/v1/adam/contacts" \
  -H "X-API-Key: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a contact for John Smith, email [email protected], phone +1234567890, customer type"
  }'

Update Contact

Update an existing contact by UUID.
uuid
string
required
Contact UUID
name
string
Contact name
email
string
Contact email
phone
string
Contact phone number
address
string
Contact address
type
string
Contact type (e.g., “customer”, “supplier”)
curl -X PUT "https://api.useadam.io/v1/adam/contacts/contact-uuid" \
  -H "X-API-Key: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "email": "[email protected]",
    "phone": "+1234567890",
    "address": "123 Main St",
    "type": "customer"
  }'

Delete Contact

Delete a contact by UUID.
uuid
string
required
Contact UUID