Use The Keyword Membership Change Trigger Node In Workflows

The Keyword Membership Change trigger node begins a workflow when an contact gets added or removed from a subscription keyword.

About this task

Note: Once an initial SMS is received, the person begins an SMS session which lasts for 1 hour. During the life of the session, any additional SMS messages received from that person are considered SMS replies.
Note: When a person texts in to a keyword, the keyword must be the first thing contained in the SMS message they are sending to you. Additional content is allowed, but the keyword must be first.

For more information on creating SMS subscription keywords, see Create SMS Keywords. For more information on setting up the SMS integration and creating keywords, see SMS Compliance.

To use the Keyword Membership Change trigger node:


  1. Create a new workflow or edit an existing workflow.
    To create a new workflow, go to Automation > Workflows and click Create New Workflow.
    Note: If you created a new workflow, make sure you name it by clicking the pencil icon above the Node Palette.
  2. Drag the Keyword Membership Change trigger node on to the workflow canvas.
  3. Click on added to.
  4. From the SMS Activity Type pull-down menu, select one of the following:
    • Added to: This option will trigger the workflow when a contact is added to a specific keyword.
    • Removed from: This option will trigger the workflow when a contact is removed from a specific keyword.
  5. Click Done.
  6. Click on a subscription keyword.
  7. In the pop-up window, click the row associated with the keyword you want to use.

    You only select SMS keywords from this list. You cannot use Text-To-Join keywords to trigger this workflow.

  8. Click Select.

What to do next

You can use the Stop SMS Session action node to end an SMS session when a workflow completes. For more information on using the Stop SMS Session action node, see Use The Stop SMS Session Action Node In Workflows.