Launchpad HTTP API (Developer)

Please note that Launchpad (formerly known as the "in-app widget" or "announcement center") is available as a feature only in our Growth plans and above.
An alternate Notification Center version of this API has been deprecated and all calls should be made to taco as shown in the example below.

Introduction

The Appcues API provides an HTTP endpoint for accessing  all the content that a user is qualified to see within the Appcues Launchpad.

Connecting

The root URL for the Appcues API is  https://api.appcues.com/.

The URL to fetch the list of content is formed using your Appcues account ID (visible from your  Appcues account page) and the end user's ID (the first parameter to your site code's Appcues.identify()call), as follows:

https://api.appcues.com/v1/accounts/{account_id}/users/{user_id}/taco

Request Format

The user activity endpoint accepts only GET requests.

The request should contain the following query parameter:

url The URL of the current page the user is on. This is used for page-level filtering.

Response Format

A successful user activity submission will result in a response with status code 200, and a response body like the following:

{"request_id":"abc123","contents":[]}

request_id Request_id specified in the request, if any.

contents An array of content for which the user currently qualifies. Used internally by the Appcues SDK; safe for external users to ignore.