Configuration properties Display name review Creating a Notify configuration Viewing Notify configurations Updating a Notify configuration Deleting a Notify configuration

Managing Notify configurations

A Notify configuration is the central resource for Notify. It defines your display name, use case, enabled channels, enabled countries, and optional settings like a default template and associated phone pool.

Configuration properties

Display name: A name that identifies your brand. Alphanumeric characters, underscores, hyphens, and spaces are allowed. Maximum 15 characters. When you submit a display name, it is automatically reviewed for profanity, URLs, and other disallowed content. See Display name review.
Use case: The messaging use case. Currently, CODE_VERIFICATION is supported.
Enabled channels: The channels available for sending: SMS, VOICE, or both.
Enabled countries: The countries you can send messages to. Available countries depend on your tier. See Notify supported countries.
Default template: (Optional) A template used when you send a message without specifying a template ID.
Associated pool: (Optional) A phone pool containing your own origination identities. See Using dedicated numbers with Notify.
Tier: BASIC (default) or ADVANCED. See Upgrading to Advanced tier.
Status: The current status: PENDING, ACTIVE, REJECTED, or REQUIRES_VERIFICATION. You can send messages only when the status is ACTIVE.
Deletion protection: When enabled, the configuration cannot be deleted until deletion protection is disabled.
Tags: Key-value pairs for organizing and tracking your configurations. Maximum 50 tags per configuration.

Display name review

When you create a Notify configuration, your display name is automatically reviewed for profanity, URLs, and other disallowed content. This review uses Amazon Bedrock, an AWS AI service, to evaluate the submitted display name.

If your display name is rejected, the configuration status is set to REJECTED and the RejectionReason field provides details. If you believe the rejection was made in error, you can create a support case in the AWS Support Center to appeal the decision.

Using a display name owned by another organization

If you are sending messages on behalf of another organization and want to use their brand name as your display name, you must provide a letter of authorization (LOA) from the brand owner. Download the brand verification LOA template, have the brand owner complete and sign it, and attach it to your support case or registration. The LOA must be dated within the last 30 days.

Opting out of AI-assisted review

If you prefer not to have your display name evaluated via AI-assisted review, you can create a support case in the AWS Support Center and request that a Notify configuration be created manually on your behalf instead.

Creating a Notify configuration

Viewing Notify configurations

Updating a Notify configuration

You can update the enabled channels, enabled countries, default template, associated pool, and deletion protection settings.

Deleting a Notify configuration

Note

If deletion protection is enabled, you must disable it before you can delete the configuration.

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Getting started with Notify

Working with Notify templates