# Create a replica Telegram integration

**POST /v1/replicas/{replicaUUID}/integrations/telegram**

Integrates a replica to Telegram. The default Sensay Telegram integration will run a bot for you until you delete the integration.


## Servers
- https://api.sensay.io: https://api.sensay.io ()


## Authentication methods
- Organization service token & User
- Organization service token


## Parameters
### Headers
- **X-API-Version** (string)


### Path parameters
- **replicaUUID** (string(uuid))
  The replica unique identifier (UUID)


### Body: application/json (object)

- **telegram_token** (string)
  Telegram Bot ID
- **mention** (string)
  Telegram Bot Name


## Responses
### 200
Telegram integration created successfully

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **id** (number)


### 202
Telegram integration created successfully, but failed to notify the external integration server. If you are using the default Sensay Telegram Integration, we will retry starting the bot asynchronously.

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **id** (number)

- **message** (string)
  The reason why the operation is accepted instead of returning an immediate success.

### 400
Bad Request

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 401
Unauthorized

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 404
Not Found

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 415
Unsupported Media Type

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 500
Internal Server Error

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting
- **inner_exception** (object)
  The inner exception


[Powered by Bump.sh](https://bump.sh)