Postman Collection

Setup

Get the Collection

View the Postman collection or directly import it by clicking the button below.

Setup Environment Variables

To use this collection, you will need to have an account, and have at least one app setup. You will need the following values to run most of the API calls in the collection: appId, userId, keyId, secret and conversationId.

  1. appId: The ID of the app with which you want to test the API. The appId can be found on the App Settings page.
  2. apiVersion: The API version to use. See API versioning to learn more.
  3. userId: The user to whom you want to send the test messages. You can get a userId in a few different ways:

    • Send a test message to that app using the web SDK. This message will then appear in the logs on App Logs page, with an userId. If you use this method, you will be setup and able to view the messages sent from the Postman collection.
    • Pre-create the user with an API call. Create user is available in the Postman collection. You can then use the chosen userId to test your API calls.
  4. conversationId: The conversation that you are targeting. You can get it in a few different ways:

    • Send a test message to that app using the web SDK. This message will then appear in the logs on App Logs page, with a conversationId.
    • Pre-create the conversation with an API call. Create conversation is available in the Postman collection.
  5. keyId: You will need an API key ID to authenticate your calls. See our guide docs for more information.
  6. secret: You will need an API key secret to authenticate your calls. See our guide docs for more information.
Create a new environment through Manage EnvironmentsPostman Environment Menu
Add your values herePostman Environment Variables