Actually what I would like to implement is that whenever a subscriber replies JOIN to the short/long code he/she will be opted-in to all of the keywords under that code.

is that possible? What would be the best approach for this request?

2 Answers 2


There are 2 ways to Opt-In for a Keyword.

Opt-In Keyword via API:

You can use QueueMO API to add a contact to a particular keyword using ampscript by forming the below body.

POST https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com/sms/v1/queueMO
Content-Type: application/json
Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN
  "mobileNumbers": [
  "shortCode": "Code",
  "messageText": "KEYWORD"

Opt-In Via Import Contacts:

Go to Mobile Studio > Mobile Connect > Add contacts > Import contacts > upload all the contacts > select the Short/long code > Select the keywords > Map the fields.

Let me know if this helps.

  • 1
    Unless I'm mistaken, triggering a QMO for each keyword would send an individual text for each keyword under the shortcode though. 20 keywords would mean 20 additional texts fired. Jun 3, 2020 at 14:32
  • No, it won't trigger an individual text for each keyword when using the above API. If you look at the body of the API, there is no option for you to pass a message. You will only pass mobile number, short/long code & Keyword.
    – Naveen VM
    Jun 3, 2020 at 15:24
  • You don't pass a message through the API, but the actual Opt-In message configured in Mobile Connect for the keyword will send a confirmation text to the subscriber. Jun 3, 2020 at 15:58
  • If you configured a keyword for outbound SMS then it won't send a sms. But if you configured a text response keyword then it will send a sms.
    – Naveen VM
    Jun 3, 2020 at 16:51
  • Configuring the message as anything other than a a Mobile Opt-In would not result in the user being opted in. A Mobile Opt-In message in Mobile Connect requires a confirmation message. So yes, they would receive a confirmation text for every QMO sent. Jun 3, 2020 at 18:31

I would be concerned about the legal aspect of this, as when someone JOINs a keyword, they are expecting a certain frequency of sms messages.

BUT, I would run an hourly automation that used a SQL activity to find all mobile connect contacts that joined that specific keyword/shortcode in the last hour. Using the resulting data extension, run the import definition as described by Elliot Harper in this post: https://salesforce.stackexchange.com/a/136819/54325

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.