> ## Documentation Index
> Fetch the complete documentation index at: https://docs.greetmate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# [POST] Make Outgoing Call

> Initiate an outbound call via Greetmate using JSON body and Bearer auth.

Endpoint:

```
https://www.greetmate.ai/api/make-outgoing-call
```

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token used for authentication.
  `Authorization: Bearer &lt;api_token&gt;`
</ParamField>

<ParamField header="X-API-KEY" type="string">
  Optional duplicate of the bearer token. Often set by Zapier automatically.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  `application/json`
</ParamField>

<ParamField header="X-Team-Id" type="integer">
  Optional. Scope the request to a specific team.

  <Card>
    <img src="https://mintcdn.com/greetmateinc/5nFQEhE3jDCMkeuu/images/content/team_id.jpg?fit=max&auto=format&n=5nFQEhE3jDCMkeuu&q=85&s=cae5d10b08ff731bbb673d0f3297550a" alt="Team ID" height="200" data-path="images/content/team_id.jpg" />
  </Card>
</ParamField>

### Body Parameters

<ParamField body="number" type="string" required>
  Destination phone number in E.164 format (e.g., `+15551234567`).
</ParamField>

<ParamField body="custom_variables" type="object">
  Optional key-value pairs passed to the workflow/call.

  <Card>
    <img src="https://mintcdn.com/greetmateinc/5nFQEhE3jDCMkeuu/images/content/custom_variables.jpg?fit=max&auto=format&n=5nFQEhE3jDCMkeuu&q=85&s=703beb4fa45fae64a71c3e13899db683" alt="Custom Variables" width="200" data-path="images/content/custom_variables.jpg" />
  </Card>
</ParamField>

<ParamField body="bot_id" type="integer">
  Optional. Specific bot/agent to use.

  <Card>
    <img src="https://mintcdn.com/greetmateinc/5nFQEhE3jDCMkeuu/images/content/bot_id.jpg?fit=max&auto=format&n=5nFQEhE3jDCMkeuu&q=85&s=1a1d00a0b44bae000389576d7fea1542" alt="Bot ID" height="200" data-path="images/content/bot_id.jpg" />
  </Card>
</ParamField>

<ParamField body="workflow_id" type="integer">
  Optional. Workflow to execute.
</ParamField>

<ParamField body="team_id" type="integer">
  Optional. Target team. Prefer the `X-Team-Id` header when possible.
</ParamField>

### Request Example (cURL)

```bash theme={null}
curl -X POST "https://www.greetmate.ai/api/make-outgoing-call" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Team-Id: 42" \
  -d '{"number":"+15551234567","custom_variables":{"lead_name":"John Doe","source":"Zapier"},"bot_id":101,"workflow_id":202}'
```

### Example Request (Zapier)

```json theme={null}
{
  "number": "+15551234567",
  "custom_variables": {"lead_name": "John Doe", "source": "Zapier"},
  "bot_id": 101,
  "workflow_id": 202,
  "team_id": 42
}
```

### Response

```json theme={null}
{
  "status": "success",
  "call_id": "call_abc123",
  "message": "Call initiated."
}
```
