Create keyword
Create an opt-in keyword with a reply, optionally with a coupon.
MCP tool postscript_write → create_keyword
write Confirm
Uses Acquisition > Keywords > Create Keyword and Save Keyword. The name is visible to subscribers. With a coupon, Postscript's Include coupon in reply is turned on with a percent or dollar amount; without one, the reply is added as an action. Anyone who texts the word is added to your SMS list and gets the reply, so it reaches people. More than two keywords need the Growth, Professional or Enterprise plan. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| keyword string required | string | The word people text, for example VIPACCESS. |
| reply string | string | Reply text sent after opt-in. |
| coupon_type enum | enum | percent or amount. Leave out for no coupon. |
| coupon_value number | number | Percent or dollar amount of the coupon. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "postscript_write",
"arguments": {
"operation": "create_keyword",
"arguments": {
"keyword": "VIPACCESS",
"reply": "You are in! Here is 15% off, a day before the public.",
"coupon_type": "percent",
"coupon_value": 15
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"keyword": "VIPACCESS",
"reply": "You are in! Here is 15% off, a day before the public.",
"coupon": {
"type": "percent",
"value": 15
}
},
"isError": false
}