TagContactCommand

Adds the specified tags to the contact resource. For more information about this API is used, see Set up granular billing for a detailed view of your Amazon Connect usage .

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { ConnectClient, TagContactCommand } from "@aws-sdk/client-connect"; // ES Modules import
// const { ConnectClient, TagContactCommand } = require("@aws-sdk/client-connect"); // CommonJS import
const client = new ConnectClient(config);
const input = { // TagContactRequest
  ContactId: "STRING_VALUE", // required
  InstanceId: "STRING_VALUE", // required
  Tags: { // ContactTagMap // required
    "<keys>": "STRING_VALUE",
  },
};
const command = new TagContactCommand(input);
const response = await client.send(command);
// {};

TagContactCommand Input

See TagContactCommandInput for more details

Parameter
Type
Description
ContactId
Required
string | undefined

The identifier of the contact in this instance of Amazon Connect.

InstanceId
Required
string | undefined

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

Tags
Required
Record<string, string> | undefined

The tags to be assigned to the contact resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.

Authorization is not supported by this tag.

TagContactCommand Output

See TagContactCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.

Throws

Name
Fault
Details
InternalServiceException
server

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

InvalidParameterException
client

One or more of the specified parameters are not valid.

InvalidRequestException
client

The request is not valid.

ResourceNotFoundException
client

The specified resource was not found.

ThrottlingException
client

The throttling limit has been exceeded.

ConnectServiceException
Base exception class for all service exceptions from Connect service.