Skip to content
eConsent API

STOP & HELP Keywords

eConsent SMS automatically processes STOP and HELP keywords per CTIA guidelines. Forward carrier webhook events to these endpoints and eConsent handles the rest.

STOP Keyword Processing

Section titled “STOP Keyword Processing”

Endpoint

Section titled “Endpoint”
POST https://sms.econsent.org/v1/sms/stop-webhook
Authorization: Bearer ec_sms_YOUR_KEY
Content-Type: application/json

Request

Section titled “Request”
{
  "phone": "+15551234567",
  "sending_entity": "Acme Insurance LLC",
  "keyword_text": "STOP",
  "inbound_message_text": "STOP"
}

Recognized Keywords

Section titled “Recognized Keywords”

STOP, UNSUBSCRIBE, CANCEL, END, QUIT, STOPALL, STOP ALL, ARRET, PARAR, ALTO

All matched case-insensitively.

Response

Section titled “Response”
{
  "keyword_matched": "STOP",
  "consents_revoked": 1,
  "revocation_id": "rev_sms_abc123",
  "honor_by_date": "2026-05-01T14:30:00Z"
}

The honor_by_date is calculated as 10 business days from the STOP, per FCC requirements.

HELP Keyword Processing

Section titled “HELP Keyword Processing”

Endpoint

Section titled “Endpoint”
POST https://sms.econsent.org/v1/sms/help-webhook
Authorization: Bearer ec_sms_YOUR_KEY
Content-Type: application/json

Request

Section titled “Request”
{
  "phone": "+15551234567",
  "sending_entity": "Acme Insurance LLC",
  "keyword_text": "HELP"
}

Recognized Keywords

Section titled “Recognized Keywords”

HELP, INFO, SUPPORT — case-insensitive.

Response

Section titled “Response”
{
  "keyword_matched": "HELP",
  "help_response": "Acme Insurance SMS alerts. For help, contact support@acme.com or call 1-800-555-0123. Reply STOP to opt out. Msg&Data rates may apply.",
  "sending_entity": "Acme Insurance LLC",
  "responded": true
}

The help_response text is configurable per campaign. If you have an sms_campaigns record with a custom help_response in its metadata, that text is used. Otherwise, a generic response is generated from the sending_entity name.