Skip to main content
POST
/
agent
Initiate Call
curl --request POST \
  --url https://api.plura.ai/v1/agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent": "aa951bc8-2942-4a75-9162-ba9946c7808",
  "phone": "17145551234",
  "from": "15045798220",
  "request_data": {
    "first_name": "John",
    "last_name": "Smith",
    "appointment_date": "2024-03-15"
  }
}
'
{
  "call_id": "0b62751b-9023-4f5d-a52c-2ea233240ed",
  "to": "17145551234",
  "from": "15045798220",
  "agent": "aa951bc8-2942-4a75-9162-ba9946c7808"
}

Documentation Index

Fetch the complete documentation index at: https://docs.plura.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

API key from Settings → API Keys in your workspace

Body

application/json
​
agent
string
required

Agent UUID from your workspace

Example:

"aa951bc8-2942-4a75-9162-ba9946c7808"

​
phone
string
required

Recipient phone number in E.164 format

Example:

"17145551234"

​
from
string

Caller ID. If omitted, auto-selected from the agent's phone group.

Example:

"15045798220"

​
request_data
object

Flexible context data passed directly to your workflow. Accepts any JSON structure.

Example:
{
  "first_name": "John",
  "last_name": "Smith",
  "appointment_date": "2024-03-15",
  "service_type": "consultation"
}

Response

Call initiated successfully

​
call_id
string
Example:

"0b62751b-9023-4f5d-a52c-2ea233240ed"

​
to
string
Example:

"17145551234"

​
from
string
Example:

"15045798220"

​
agent
string
Example:

"aa951bc8-2942-4a75-9162-ba9946c7808"