# Twilio - Proxy API

> Twilio - Proxy API on Apizie: 25 endpoints (Retrieve a list of Interactions for a given [Session](https://www.twilio.com/docs/proxy/api/session)., Delete a specific Interaction., Retrieve a list of all Interactions for a Session. A maximum of 100 records will be returned per page., GET /v1/Services/{ServiceSid}/Sessions/{SessionSid}/Participants/{ParticipantSid}/MessageInteractions, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:twilio-twilio-proxy-v1`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://www.apizie.tech/api/communication/twilio-twilio-proxy-v1
- OpenAPI: https://www.apizie.tech/api/communication/twilio-twilio-proxy-v1/openapi.json

This is the public Twilio REST API.

## Endpoints

### Retrieve a list of Interactions for a given [Session](https://www.twilio.com/docs/proxy/api/session).
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to fetch. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resource to fetch. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Interaction resource to fetch. |

### Delete a specific Interaction.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/delete-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to delete. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resource to delete. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Interaction resource to delete. |

### Retrieve a list of all Interactions for a Session. A maximum of 100 records will be returned per page.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) to read the resources from. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) to read the resources from. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### GET /v1/Services/{ServiceSid}/Sessions/{SessionSid}/Participants/{ParticipantSid}/MessageInteractions
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-message-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) to read the resources from. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) to read the resources from. |
| ParticipantSid | string | yes | The SID of the [Participant](https://www.twilio.com/docs/proxy/api/participant) to read the resources from. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new message Interaction to send directly from your system to one…
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/create-message-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) resource. |
| ParticipantSid | string | yes | The SID of the [Participant](https://www.twilio.com/docs/proxy/api/participant) resource. |
| body | object | no | Form fields as a JSON object |

### GET /v1/Services/{ServiceSid}/Sessions/{SessionSid}/Participants/{ParticipantSid}/MessageInteractions/{Sid}
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-message-interaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to fetch. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resource to fetch. |
| ParticipantSid | string | yes | The SID of the [Participant](https://www.twilio.com/docs/proxy/api/participant) resource. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the MessageInteraction resource to fetch. |

### Fetch a specific Participant.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to fetch. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resource to fetch. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Participant resource to fetch. |

### Delete a specific Participant. This is a soft-delete. The participant remains associated with the session…
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/delete-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to delete. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resource to delete. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Participant resource to delete. |

### Retrieve a list of all Participants in a Session.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resources to read. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) of the resources to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Add a new Participant to the Session
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/create-participant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. |
| SessionSid | string | yes | The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) resource. |
| body | object | no | Form fields as a JSON object |

### Retrieve a list of all Phone Numbers in the Proxy Number Pool for a Service. A maximum of 100 records will…
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the PhoneNumber resources to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Add a Phone Number to a Service's Proxy Number Pool.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/create-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID parent [Service](https://www.twilio.com/docs/proxy/api/service) resource of the new PhoneNumber resource. |
| body | object | no | Form fields as a JSON object |

### Fetch a specific Phone Number.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the PhoneNumber resource to fetch. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the PhoneNumber resource to fetch. |

### Update a specific Proxy Number.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/update-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the PhoneNumber resource to update. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the PhoneNumber resource to update. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Phone Number from a Service.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/delete-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the PhoneNumber resource to delete. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the PhoneNumber resource to delete. |

### Fetch a specific Service.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Service resource to fetch. |

### Update a specific Service.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/update-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Service resource to update. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Service.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/delete-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Service resource to delete. |

### Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Service for Twilio Proxy
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/create-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch a specific Session.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to fetch. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Session resource to fetch. |

### Update a specific Session.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/update-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to update. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Session resource to update. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Session.
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/delete-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to delete. |
| Sid | string | yes | The Twilio-provided string that uniquely identifies the Session resource to delete. |

### Retrieve a list of all Sessions for the Service. A maximum of 100 records will be returned per page.
`GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/list-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) of the resource to read. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Session
`POST https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/create-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ServiceSid | string | yes | The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. |
| body | object | no | Form fields as a JSON object |

## Example
```
curl "https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-interaction" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio - Proxy API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/communication:twilio-twilio-proxy-v1/fetch-interaction with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio - Proxy API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio - Proxy itself also needs your own key from twilio.

### Can AI agents use the Twilio - Proxy API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:twilio-twilio-proxy-v1.

### What is the status of the Twilio - Proxy API?
Needs your own provider key (bring your own key)