CreateRoutingProfile - Amazon Connect

CreateRoutingProfile

Creates a new routing profile.

Request Syntax

PUT /routing-profiles/InstanceId HTTP/1.1 Content-type: application/json { "AgentAvailabilityTimer": "string", "DefaultOutboundQueueId": "string", "Description": "string", "MediaConcurrencies": [ { "Channel": "string", "Concurrency": number, "CrossChannelBehavior": { "BehaviorType": "string" } } ], "Name": "string", "QueueConfigs": [ { "Delay": number, "Priority": number, "QueueReference": { "Channel": "string", "QueueId": "string" } } ], "Tags": { "string" : "string" } }

URI Request Parameters

The request uses the following URI parameters.

InstanceId

The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Length Constraints: Minimum length of 1. Maximum length of 100.

Required: Yes

Request Body

The request accepts the following data in JSON format.

AgentAvailabilityTimer

Whether agents with this routing profile will have their routing order calculated based on longest idle time or time since their last inbound contact.

Type: String

Valid Values: TIME_SINCE_LAST_ACTIVITY | TIME_SINCE_LAST_INBOUND

Required: No

DefaultOutboundQueueId

The default outbound queue for the routing profile.

Type: String

Required: Yes

Description

Description of the routing profile. Must not be more than 250 characters.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 250.

Required: Yes

MediaConcurrencies

The channels that agents can handle in the Contact Control Panel (CCP) for this routing profile.

Type: Array of MediaConcurrency objects

Required: Yes

Name

The name of the routing profile. Must not be more than 127 characters.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 127.

Required: Yes

QueueConfigs

The inbound queues associated with the routing profile. If no queue is added, the agent can make only outbound calls.

The limit of 10 array members applies to the maximum number of RoutingProfileQueueConfig objects that can be passed during a CreateRoutingProfile API request. It is different from the quota of 50 queues per routing profile per instance that is listed in Amazon Connect service quotas.

Type: Array of RoutingProfileQueueConfig objects

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No

Tags

The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "RoutingProfileArn": "string", "RoutingProfileId": "string" }

Response Elements

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

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

RoutingProfileArn

The Amazon Resource Name (ARN) of the routing profile.

Type: String

RoutingProfileId

The identifier of the routing profile.

Type: String

Errors

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

DuplicateResourceException

A resource with the specified name already exists.

HTTP Status Code: 409

InternalServiceException

Request processing failed because of an error or failure with the service.

HTTP Status Code: 500

InvalidParameterException

One or more of the specified parameters are not valid.

HTTP Status Code: 400

InvalidRequestException

The request is not valid.

HTTP Status Code: 400

LimitExceededException

The allowed limit for the resource has been exceeded.

HTTP Status Code: 429

ResourceNotFoundException

The specified resource was not found.

HTTP Status Code: 404

ThrottlingException

The throttling limit has been exceeded.

HTTP Status Code: 429

See Also

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