# telephony_disconnected

- HTTP status: 422
- Retry: No
- Execution: not started
- Admin needed: yes

**Telephony connection down.** Before dialling a campaign the API checks that the workspace's telephony connection is healthy. It is not, so the campaign was set to `paused` and nothing was dialled.

## What it means

The API returns HTTP 422 with `error.code` set to `telephony_disconnected`. The default message is: "The telephony connection for this workspace is not working, so the campaign was paused."

## Common causes

- The telephony account connected in the console was disconnected, suspended or its credentials changed.

## How to identify it

Check the response status (`422`) and `error.code` (`telephony_disconnected`). Branch on `error.code`, not on the message text: messages can be reworded, codes do not change within v1. Log `error.request_id` (also sent as the `X-Request-Id` header) so support can find the request.

## How to fix it

- Reconnect the telephony account in the console, then start or resume the campaign again.

## Retry guidance

Sending the request unchanged fails the same way. Fix the cause first (see How to fix it), then send it again.

## Did anything happen?

This request was refused before any call was placed and before anything was charged.

## Idempotency

Nothing was done and the refusal is not stored under the Idempotency-Key. Fix the cause, then send the same request (with the same key if you sent one).

## Who can fix it

A workspace administrator usually has to act, in the RelationsAI console.

## When to contact support

If the console shows the connection as healthy, write to [support@relationsai.com](mailto:support@relationsai.com) with the request_id. See [Support](/resources/support) for what to include (the `request_id`, the time in UTC, the operation, and whether you used a test or live key) and what never to send (API keys, Authorization headers, webhook signing secrets, recording links, transcripts or customer data).

## Example error response

```json
{
  "error": {
    "code": "telephony_disconnected",
    "message": "The telephony connection for this workspace is not working, so the campaign was paused.",
    "details": {},
    "request_id": "req_jntj2br6copym7cpnivap4gm",
    "retry": "no",
    "doc_url": "https://docs.relationsai.com/errors/telephony_disconnected"
  }
}
```

## Operations that can return this error

- [`POST /campaigns/{campaign_id}/start`](/api/campaigns#start-a-campaign): Start a campaign
- [`POST /campaigns/{campaign_id}/resume`](/api/campaigns#resume-a-campaign): Resume a campaign

See all codes in the [error-code reference](/fundamentals/error-codes).