---
title: "Manually trigger a keyword interaction"
method: POST
path: "/api/sms/{msisdn}/keywords"
tags: ["SMS"]
---

# Manually trigger a keyword interaction

`POST /api/sms/{msisdn}/keywords`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/sms/{msisdn}/keywords`
- Auth: one of:
  - HTTP basic
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/airship/apis/airship-api/docs/api/sms/:msisdn/keywords/post.ts> (a function with typed inputs; its response is checked against the schema)

Trigger Mobile Originated (MO) keyword interactions on behalf of an MSISDN.

## Path parameters

- `msisdn` string, required

## Headers

- `X-UA-Appkey` string, required

## Request body

- object
  - `keyword` string, required: The keyword you want to trigger an action for. Must be an alphanumeric string with no spaces.
  - `sender_ids` SenderId[], required: The [sender IDs](/developer/rest-api/ua/schemas/others/#sender_id) with keyword actions that you want to test. Airship returns a 400 if the `keyword` is not configured for one or more of the senders in the array.
  - `timestamp` string, date-time: The [date-time](/developer/rest-api/ua/introduction/#date-time-format) when the MO keyword was sent. If absent, Airship uses the server-time of your request.

## Response `200`

The operation was successful.

- object
  - `ok` boolean: If `true`, your request was successful.

## Other responses

- `400`: The operation was not successful. If the request is formatted correctly, one or more `sender_ids` does not exist or the keyword is not configured for one or more of the `sender_ids`.

---

[API](https://skmtc.dev/airship/apis/airship-api.md) - [All operations](https://skmtc.dev/airship/apis/airship-api/llms.txt) - [OpenAPI document](https://skmtc.dev/airship/apis/airship-api/revisions/bd6ab947117a?raw)