CreateSipMediaApplicationCall - Amazon Chime SDK


Creates an outbound call to a phone number from the phone number specified in the request, and it invokes the endpoint of the specified sipMediaApplicationId.

Request Syntax

POST /sip-media-applications/sipMediaApplicationId/calls HTTP/1.1 Content-type: application/json { "ArgumentsMap": { "string" : "string" }, "FromPhoneNumber": "string", "SipHeaders": { "string" : "string" }, "ToPhoneNumber": "string" }

URI Request Parameters

The request uses the following URI parameters.


The ID of the SIP media application.

Pattern: .*\S.*

Required: Yes

Request Body

The request accepts the following data in JSON format.


Context passed to a CreateSipMediaApplication API call. For example, you could pass key-value pairs such as: "FirstName": "John", "LastName": "Doe"

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Required: No


The phone number that a user calls from. This is a phone number in your Amazon Chime SDK phone number inventory.

Type: String

Pattern: ^\+?[1-9]\d{1,14}$

Required: Yes


The SIP headers added to an outbound call leg.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Required: No


The phone number that the service should call.

Type: String

Pattern: ^\+?[1-9]\d{1,14}$

Required: Yes

Response Syntax

HTTP/1.1 201 Content-type: application/json { "SipMediaApplicationCall": { "TransactionId": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.


The actual call.

Type: SipMediaApplicationCall object


For information about the errors that are common to all actions, see Common Errors.


You don't have the permissions needed to run this action.

HTTP Status Code: 403


The input parameters don't match the service's restrictions.

HTTP Status Code: 400


The client is permanently forbidden from making the request.

HTTP Status Code: 403


The request exceeds the resource limit.

HTTP Status Code: 400


The service encountered an unexpected error.

HTTP Status Code: 500


The service is currently unavailable.

HTTP Status Code: 503


The number of customer requests exceeds the request rate limit.

HTTP Status Code: 429


The client isn't authorized to request a resource.

HTTP Status Code: 401

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: