Menu
Amazon Pinpoint
REST API Reference

Apps

An app is an Amazon Pinpoint project in which you define the audience for a distinct application, and you engage this audience with tailored messages. For example, use an app to send push notifications to your mobile app users, send emails to your newsletter subscribers, or send SMS messages to your customers' phone numbers.

After you create an app, you can define your audience by registering endpoints and defining segments. To engage your audience, define campaigns or write direct messages, and send your messages using any supported channel (mobile push, email, and SMS).

You can monitor app analytics by creating an event stream, which streams data for message deliveries and events reported by your application. Analytics are also provided in the Amazon Pinpoint console. In the console, you can open your app on the Projects page.

Use this resource to look up or create an app.

To delete an app, use the App resource and run a DELETE request against the /apps/application-id URI.

URI

/v1/apps

HTTP Methods

GET

Returns information about your apps.

Header

Name Required Type

accept

false

string

Query

Name Required Type

page-size

false

string

token

false

string

Response

Status Code Schema

200

ApplicationsResponse

POST

Creates or updates an app.

Body

Name Required Type

CreateApplicationRequest

true

CreateApplicationRequest

Header

Name Required Type

accept

false

string

Response

Status Code Schema

201

ApplicationResponse

Errors

Errors

Status Code Schema Error Type

400

MessageBody

BadRequestException

403

MessageBody

ForbiddenException

404

MessageBody

NotFoundException

405

MessageBody

MethodNotAllowedException

429

MessageBody

TooManyRequestsException

500

MessageBody

InternalServerErrorException

Schemas

Request Schemas

Example CreateApplicationRequest

Copy
{ "Name": "string" }

Response Schemas

Example ApplicationsResponse

Copy
{ "PageToken": "string", "Applications": [ { "Name": "string", "Id": "string" } ] }

Example ApplicationResponse

Copy
{ "Name": "string", "Id": "string" }

Example MessageBody

Copy
{ "RequestID": "string", "Message": "string" }

Attributes

CreateApplicationRequest

Attribute Type Description

Name

string

The display name of the application. Used in the Amazon Pinpoint console.

ApplicationsResponse

Attribute Type Description

Item

array

List of applications returned in this page.

NextToken

string

The string that you use in a subsequent request to get the next page of results in a paginated response.

ApplicationResponse

Attribute Type Description

Id

string

The unique application ID.

Name

string

The display name of the application.

MessageBody

Attribute Type Description

Message

string

The error message returned from the API.

RequestID

string

The unique message body ID.