> For the complete documentation index, see [llms.txt](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/calls/initiate-a-call.md).

# Initiate a Call

POST /calls/initiate/

Use the `POST /calls/initiate/` endpoint to start a new call session between a car owner and a mechanic. The `mechanic_id` identifies the mechanic to connect with, while the `room_id` uniquely defines the call session.

**Request Body Parameters**:\
The request body must include the following fields in JSON format:

<table data-header-hidden><thead><tr><th width="108"></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td></tr><tr><td><code>mechanic_id</code></td><td>string</td><td>Yes</td><td>The unique ID of the mechanic.</td></tr><tr><td><code>room_id</code></td><td>string</td><td>Yes</td><td>The unique ID for the call session.</td></tr></tbody></table>

**Example Request**:

```bash
curl -X POST "https://requestnowmechanic.com/v1/calls/initiate/" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mechanic_id": "12345",
    "room_id": "room_abc123"
  }'
```

**Successful Response**:

* **Status Code**: `201 Created`
* **Description**: The call session was successfully initiated.
* **Response Body Example**:

  ```json
  {
    "mechanic_id": "12345",
    "room_id": "room_abc123"
  }
  ```