These docs are for v1.0. Click to read the latest docs for v2.0.

Create Subscriber with Keyword

Adds a Postscript subscriber to your shop and sends a reply based on which Keyword you specify in the request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

To find available keywords or inspect keyword replies, use Get Keywords endpoint.

📘

Note

  • Adding the field shopify_customer_id or email to the metadata object will help Postscript identify which customer belongs to the phone number you are sending.

  • The field metadata.tags will be stored on the subscriber, so those subscribers can later be filtered into segments by these tags.

  • You must pass either a keyword_id or keyword body param when adding a subscriber. You do not need to pass both. Which one you choose is up to you.

  • In the response, is_pending refers to the state of the subscriber that was added. Every subscriber added via our API requires a confirmation to opt-in for compliance reasons (see below section). If they have not confirmed yet, they will be in the pending state. Once confirmed, they will no longer be pending.

❗️

Text Messaging Compliance

All subscribers added using this endpoint will be required to confirm they have opted in to receive recurring automated messages. If a subscriber does not confirm, then they are not added to a merchant's subscriber list.

For more information about compliance, see our guide here.

Body Params
string
required
Defaults to 555-555-5555

Subscriber's phone number. No specific format required.

string

ID of the Keyword that the subscriber should be added to. This or keyword is required.

string

The Keyword to which the subscriber should be subscribed to. This or keyword_id is required.

metadata
object

Metadata that can be saved for a subscriber.

Headers
string

Shop API Token. Required for partners. This header should be used only by partners. Shops should include their API token in the Authorization header.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json