connect:SearchContacts

Read

connect:SearchContacts is a Read access-level action in the connect service. Grants permission to search contacts in an Amazon Connect instance

Resource types

ARNs that connect:SearchContacts can be scoped to in an IAM policy.

arn:${Partition}:connect:${Region}:${Account}:instance/${InstanceId} required
instance

Condition keys

Keys you can use in the Condition block of a policy that grants connect:SearchContacts.

connect:Channel String

Filters access by Channel

connect:InstanceId String

Filters access by restricting federation into specified Amazon Connect instances

connect:PreferredUserArn ARN

Filters access by PreferredUserArn

connect:SearchContactsByContactAnalysis ArrayOfString

Filters access by restricting searches using analysis outputs from Amazon Connect Contact Lens

connect:SearchTag/${TagKey} String

Filters access by TagFilter condition passed in the search request

aws:ResourceTag/${TagKey} String

Filters access by using tag key-value pairs attached to the resource

Example IAM policy

A minimal policy that allows connect:SearchContacts. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowConnectSearchContacts",
      "Effect": "Allow",
      "Action": "connect:SearchContacts",
      "Resource": "*"
    }
  ]
}

Related actions in connect

View all connect actions →