<PartnerPortalWarning />

<br />

## Request Parameters

| Key                    | Description                                   | Value                                  | Data Type | Required/Optional | Constraints                                                                                                                                             |
| :--------------------- | :-------------------------------------------- | :------------------------------------- | :-------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Authorization          | Access Token for the application              | `USER.PARTNER_APP_TOKEN`             | String    | Required          | Should be a valid Partner App Access Token                                                                                                              |
| APP ID                 | appId of the account                          | `bf9ee64c-3d4d-4ac4-xxxx-732e577007c4` | String    | Required          | Should be a valid appId                                                                                                                                 |
| enable_welcome_message | set to true to receive request_welcome events | True/False                             | Boolean   | Required          | Should be true/false                                                                                                                                    |
| commands               | configure the various commands for your apps  | List of Objects                        | List      | Required          | You can define up to 30 commands. Each command has a maximum of 32 characters, and each hint has a maximum of 256 characters. Emojis are not supported. |
| prompts                | configure the ice breakers for your apps      | List of String                         | List      | Required          | You can set up 4 ice breakers, each with a maximum of 80 characters. Emojis are not supported.                                                          |

## Sample Request

```curl
curl --location --request POST 'https://partner.gupshup.io/partner/app/{{APP_ID}}/conversational/component' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "enable_welcome_message": true,
    "commands": [
        {
            "command_name": "tickets",
            "command_description": "Book flight tickets"
        },
        {
            "command_name": "hotel",
            "command_description": "Book hotel"
        }
    ],
    "prompts": [
        "Book a flight",
        "plan a vacation"
    ]
}'

{
    "status": "success",
    "success": true
}