Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_email_channel

get_email_channel(**kwargs)

Retrieves information about the status and settings of the email channel for an application.

See also: AWS API Documentation

Request Syntax

response = client.get_email_channel(
    ApplicationId='string'
)
Parameters
ApplicationId (string) --

[REQUIRED]

The unique identifier for the application. This identifier is displayed as the Project ID on the Amazon Pinpoint console.

Return type
dict
Returns
Response Syntax
{
    'EmailChannelResponse': {
        'ApplicationId': 'string',
        'ConfigurationSet': 'string',
        'CreationDate': 'string',
        'Enabled': True|False,
        'FromAddress': 'string',
        'HasCredential': True|False,
        'Id': 'string',
        'Identity': 'string',
        'IsArchived': True|False,
        'LastModifiedBy': 'string',
        'LastModifiedDate': 'string',
        'MessagesPerSecond': 123,
        'Platform': 'string',
        'RoleArn': 'string',
        'Version': 123
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • EmailChannelResponse (dict) --

      Provides information about the status and settings of the email channel for an application.

      • ApplicationId (string) --

        The unique identifier for the application that the email channel applies to.

      • ConfigurationSet (string) --

        The Amazon SES configuration set that's applied to messages that are sent through the channel.

      • CreationDate (string) --

        The date and time, in ISO 8601 format, when the email channel was enabled.

      • Enabled (boolean) --

        Specifies whether the email channel is enabled for the application.

      • FromAddress (string) --

        The verified email address that email is sent from when you send email through the channel.

      • HasCredential (boolean) --

        (Not used) This property is retained only for backward compatibility.

      • Id (string) --

        (Deprecated) An identifier for the email channel. This property is retained only for backward compatibility.

      • Identity (string) --

        The Amazon Resource Name (ARN) of the identity, verified with Amazon Simple Email Service (Amazon SES), that's used when you send email through the channel.

      • IsArchived (boolean) --

        Specifies whether the email channel is archived.

      • LastModifiedBy (string) --

        The user who last modified the email channel.

      • LastModifiedDate (string) --

        The date and time, in ISO 8601 format, when the email channel was last modified.

      • MessagesPerSecond (integer) --

        The maximum number of emails that can be sent through the channel each second.

      • Platform (string) --

        The type of messaging or notification platform for the channel. For the email channel, this value is EMAIL.

      • RoleArn (string) --

        The ARN of the AWS Identity and Access Management (IAM) role that Amazon Pinpoint uses to submit email-related event data for the channel.

      • Version (integer) --

        The current version of the email channel.

Exceptions

  • Pinpoint.Client.exceptions.BadRequestException
  • Pinpoint.Client.exceptions.InternalServerErrorException
  • Pinpoint.Client.exceptions.PayloadTooLargeException
  • Pinpoint.Client.exceptions.ForbiddenException
  • Pinpoint.Client.exceptions.NotFoundException
  • Pinpoint.Client.exceptions.MethodNotAllowedException
  • Pinpoint.Client.exceptions.TooManyRequestsException