---
title: "Call a contact"
method: POST
path: "/contact/call"
tags: ["contact"]
---

# Call a contact

`POST /contact/call`

This endpoint allows you to initiate a call with a **Contact** using a specific **Agent**. The **Agent** will handle the conversation during the call.

## Request body

- object
  - `contact_id` string, required — The ID of the **Contact** that will be called. You cannot call a phone number until you have created a **Contact**. By creating a contact, you acknowledge that you have the necessary permissions to call the phone number.
  - `interview_id` string, required — The ID of the **Agent** that will be used to make the call. This can be found in the URL of the **Agent** page.
  - `metadata` object, nullable — Additional data that the **Agent** can reference during the call using `{key_name}`. For example, if you include `{'additional_data_1': 'value'}`, you can reference `additional_data_1` in the **Agent** script as `{additional_data_1}`.
    - `additional_data_1` string

## Response `200`

Successful response

- GenericResponse — The generic response format for all API requests. This structure ensures consistency in how success and error information is returned to the caller.
  - `error` object, nullable — An object containing error details, if any. This field will be populated if the API request fails or encounters an error. If the request is successful, this field will be null or omitted.
  - `data` object, required — Contains the response data for the successful request. This field will vary based on the specific API endpoint being called and contains the main data returned from the API. For example, it may include information about a created contact, agent, or webhook subscription.

---

[API](https://skmtc.dev/thoughtly/apis/thoughtly-api.md) · [All operations](https://skmtc.dev/thoughtly/apis/thoughtly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thoughtly/thoughtly-api/revisions/75a10c67731a/schema)