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

# Call a contact

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



## OpenAPI

````yaml post /contact/call
openapi: 3.0.0
info:
  title: Thoughtly API
  version: 1.0.0
  contact:
    name: Thoughtly Support
    email: support@thoughtly.com
    url: https://thoughtly.com
servers:
  - url: https://api.thoughtly.com
    description: Production server
security:
  - ApiKeyAuth: []
    TeamIdAuth: []
paths:
  /contact/call:
    post:
      tags:
        - contact
      summary: Call a contact
      description: >-
        This endpoint allows you to initiate a call with a **Contact** using a
        specific **Agent**. The **Agent** will handle the conversation during
        the call.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                contact_id:
                  type: string
                  description: >-
                    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:
                  type: string
                  description: >-
                    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:
                  type: object
                  description: >-
                    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}`.
                  properties:
                    additional_data_1:
                      type: string
                  nullable: true
              required:
                - contact_id
                - interview_id
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
components:
  schemas:
    GenericResponse:
      type: object
      properties:
        error:
          type: object
          nullable: true
          description: >-
            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:
          type: object
          additionalProperties: true
          description: >-
            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.
      required:
        - data
      description: >-
        The generic response format for all API requests. This structure ensures
        consistency in how success and error information is returned to the
        caller.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-token
      description: >-
        API key for the user making the request. This can be found via the
        [Developer Settings](https://app.thoughtly.com/settings/developer) page
        in the dashboard.
    TeamIdAuth:
      type: apiKey
      in: header
      name: team_id
      description: >-
        Team identifier, used to scope requests to a specific team. This can be
        found via the [Developer
        Settings](https://app.thoughtly.com/settings/developer) page in the
        dashboard.

````