Agentalk API overview

Agentalk API overview

The Agentalk API lets you manage contacts, campaigns, outbound calls, and organization-level resources programmatically.

Use it for CRM sync, lead routing, marketing automation, and AI-driven outbound workflows.

Next in the API reference

Continue to the Contacts reference.

API token

Manage your API token in Organization Settings → Account.

Keep tokens secure. Do not expose them publicly.

What you can do

With the Agentalk API, you can automate core workflows across contacts, campaigns, calls, and account resources.

Contacts

• Create or update contacts
• Search contacts by phone, name, or email
• Update or clear specific fields
• Add or remove contact tags
• Delete contacts

Campaigns

• Retrieve the campaign list
• Add contacts to campaigns
• Activate campaigns programmatically

Calls

• Initiate outbound calls
• Trigger calls from automated workflows
• Link calls to campaigns and contacts

Account management

• Manage custom fields
• Retrieve organization phone numbers
• Manage organization-level tags

Authentication

All API requests use an organization API token.

Send the token as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Each request runs in the context of your organization.

Base URL

Use the main API domain as the base URL:

https://api.agentalk.io

All endpoints are available under /api/....

Quickstart

This example authenticates with your API token, creates or updates a contact, then searches for it.

1

Set your token

Export your API token before sending requests.

export AGENTALK_API_TOKEN="YOUR_API_TOKEN"
export AGENTALK_BASE_URL="https://api.agentalk.io"

2

Create or update a contact

Send a POST request to /api/contacts.

curl --request POST "$AGENTALK_BASE_URL/api/contacts" \
  --header "Authorization: Bearer $AGENTALK_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "phone": "[phone]",
    "firstName": "Dana",
    "lastName": "Levi",
    "email": "[email protected]",
    "tags": ["demo", "quickstart"]
  }'

If the phone number already exists, the contact is updated.

3

Search for the contact

Use the phone number to confirm the contact exists.

curl --request GET "$AGENTALK_BASE_URL/api/contacts/search?phone=%2B14155550123" \
  --header "Authorization: Bearer $AGENTALK_API_TOKEN"

Ready for the next step? Go to the Contacts reference for full request and response details.

No-code and low-code automation

For faster integrations, Agentalk provides a ready-to-use Make.com app.

With the Make integration, you can:

• Connect Agentalk to CRMs, spreadsheets, forms, ads, and messaging platforms
• Build automations without writing code
• Trigger calls, manage contacts, and run campaigns visually

Get started with Agentalk's Make app, then authenticate with your API token and build scenarios immediately.

Who is this API for?

• Developers building custom integrations
• Automation specialists using Make or n8n
• CRM and marketing teams
• AI and voice automation platforms
• Agencies managing outbound workflows for clients

Whether you build with code or no-code tools, Agentalk fits into your existing stack.