---
title: "Create a phone Switch"
method: POST
path: "/phone_call_redirects"
tags: ["Switch"]
---

# Create a phone Switch

`POST /phone_call_redirects`

You can use the API to deflect phone calls to the Intercom Messenger.
Calling this endpoint will send an SMS with a link to the Messenger to the phone number specified.

If custom attributes are specified, they will be added to the user or lead's custom data attributes.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Request body

- CreatePhoneSwitchRequest, nullable — You can create an phone switch
  - `phone` string, required — Phone number in E.164 format, that will receive the SMS to continue the conversation in the Messenger.
  - `custom_attributes` CustomAttributes — An object containing the different custom attributes associated to the conversation as key-value pairs. For relationship attributes the value will be a list of custom object instance models. System-defined attributes such as "CX Score rating" and "CX Score explanation" may also be included.

## Response `200`

successful

- PhoneSwitch, nullable — Phone Switch Response
  - `type` 'phone_call_redirect'
  - `phone` string — Phone number in E.164 format, that has received the SMS to continue the conversation in the Messenger.

## Other responses

- `400` — bad request - invalid number
- `401` — Unauthorized
- `422` — unprocessable entity

---

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