apple_create_intro_offer
Creates an introductory free-trial offer for an Apple subscription in a specified territory, defining duration, offer mode, and number of periods.
Instructions
Create the subscription's introductory offer (free trial). External action.
duration: THREE_DAYS, ONE_WEEK, TWO_WEEKS, ONE_MONTH, TWO_MONTHS, THREE_MONTHS, SIX_MONTHS or ONE_YEAR. Apple has no "14 days" — TWO_WEEKS is the exact equivalent.
offer_mode: FREE_TRIAL (free), PAY_AS_YOU_GO or PAY_UP_FRONT. The last two charge a lower price and require a price point, which this tool does not cover.
territory is REQUIRED, one offer per country: Apple refuses to create the
offer without it. To apply in several countries, call once per territory.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subscription_id": "<subscription_id>"
},
"name": "apple_create_intro_offer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration | No | TWO_WEEKS | |
| territory | No | BRA | |
| offer_mode | No | FREE_TRIAL | |
| subscription_id | Yes | ||
| number_of_periods | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||