Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Contact Us
  • Home
  • Installation & Developers
  • API & Data

Appcues Public API

Updated at December 20th, 2022

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Installation & Developers
    Installing Appcues Installing Appcues Mobile API & Data Troubleshooting Extras
  • User Experiences
    Web Experiences Building Web Experiences Building Mobile Experiences Customization & Styling Targeting Studio Troubleshooting Use Cases FAQ
  • Mobile
    Installation & Overview Building Mobile Experiences Mobile Analytics Troubleshooting Mobile Use Cases
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Use Cases Pro Tips PLG FAQ
  • Integrations
    Integration Documents Use Cases Resources
  • Post-mortem
    System Incidents
+ More

Table of Contents

Appcues Public API Using the API Keys & Secret Flows End Users Segments Importing Data Exporting Data Support

Appcues Public API

Appcues offers an API that can be used to perform a variety of tasks that can make using Appcues more versatile. The API is able to access flow information, update segments & user profiles, and bulk import & export data. If you want to jump straight into the technical documentation, you can do so here.

The Appcues API is a web API that offers access to functions within the Appcues platform. Each function is identified using an HTTP method and a URL. All API requests and responses are encoded as JSON by default. Most API endpoints also support CSV input and output. 

The Appcues Public API is not available for legacy subscription tiers (reach out to sales@appcues.com if you'd like to upgrade your plan). 

 

Using the API

While there are many use cases for these endpoints, some of the most exciting things you can do are

  • Getting historical event & user property data into Appcues immediately. Without using the API, data will only be added as it's "seen".
  • Using the segment endpoints to create segments that feature more than 1000 users! 
  • Using the publish/unpublish endpoints to launch flows at exactly the right time without needing to use the Appcues Studio.

Note: some of the calls sent through the Appcues Public API can take a few minutes to complete. If you are planning on utilizing the API to send qualifying properties to user profiles, and need that information available immediately, it may be best to utilize the HTTP API.

 

Keys & Secret

All requests to the Appcues API V2 must be authenticated using an API key and secret. API keys and secrets can be created and managed in your API Keys page on studio.appcues.com.

Once you've arrived on the API Keys page, you will see a list of any existing API keys, and Appcues Account Admins will also have the ability to create new keys.

To create a new key, select the Create new key button.

Once you've clicked the button you will be asked to give your key a friendly name, and provide the level of access you want your key to have.

The next step will now show you the API Key and the Secret, with easy access to put both on a clipboard. If you're not in a position to use the secret right away, make sure you make note of it somewhere because it will NOT be available again.

If you ever need to need to view additional info about the key (like who created it), disable the key, delete a disabled key, or re-enable a disabled key, you can do so by clicking the more menu.
 

Once you have your Key & Secret, you can use it for the endpoints listed below.

NOTE: In order for a key to be deleted, it must first be disabled

NOTE: The Legacy API Key cannot be deleted or disabled, and is still needed for for the initial Installation of Appcues, as well as some integrations.

Flows

For flows, the Appcues Public API provides access to

  • Your account's list of flows 
  • Your account's flow details for a single flow
  • Publishing flows
  • Unpublishing flows

End Users

For end users, the Appcues Public API provides endpoints for

  • Getting a user's complete profile
  • Updating a user's profile
  • Getting a user's most recent events

Segments

For segments, the Appcues Public API provides endpoints for

  • Your account's list of segments
  • Your account's segment details for a single segment
  • The ability to create a segment
  • The ability to update a segment
  • The ability to delete a segment
  • The ability to update a segment by adding a specific user ID
  • The ability to update a segment by removing a specific user ID
    • Removing a user from a segment with the API only works if the user was added with the API

Importing Data

For importing data, the Appcues Public API provides endpoints for

  • Importing a single user's activity
  • Importing bulk profile data
  • Importing bulk event data

Exporting Data

For exporting data, the Appcues Public API provides endpoints for

  • Exporting bulk event data

To review this information in more detail, check out https://api.appcues.com/v2/docs

Support

When contacting support with any issues related to the API, be sure to include the full HTTP request details (for example, the curl command line used for the request) and Key Name, but never send the API key's secret.

Public API Responses

Here is a list of some of the responses that the Public API could return. Click here for more information.

  • 200 - Success. The request succeeded.
  • 201 - Created. The request succeeded, and resulted in the creation of a new resource.
  • 202 - Accepted. The request was accepted, and is being processed offline.
  • 400 - Bad Request. The request was malformed or invalid.
  • 401 - Unauthorized. Access credentials were missing or invalid.
  • 403 - Forbidden. The given credentials do not grant access to the requested resource.
  • 404 - Not Found. The given endpoint or resource could not be located in our system.
  • 415 - Unsupported Media Type. The content type specified in the Content-type header is not supported by this API.
  • 429 - Too Many Requests. Requests from this API key are being throttled due to heavy traffic.
  • 500 - Internal Server Error. Something went wrong and it's not your fault.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Welcome and Getting Started
  • Launchpad Custom Install
  • Javascript API (Developer)
  • Installation Overview (for Developers)
Appcues logo

Product

Why Appcues
How it works
Integrations
Security
Pricing
What's new

Use cases

User Onboarding Software
Feature Adoption Software
NPS & Surveys
Announcements
Insights
Mobile Adoption

Company

About
Careers
we're Hiring

Support

Developer Docs
Contact

Resources

The Appcues Blog
Product Adoption Academy
GoodUX
Case studies
Webinar Series
Made with Appcues
Appcues University

Follow us

Facebook iconTwitter icon greyLinkedin iconInstagram icon
© 2022 Appcues. All rights reserved.
SecurityTerms of ServicePrivacy Policy
Expand