---
title: "Set subscription for an app"
method: POST
path: "/partner/app/{appId}/subscription"
---

# Set subscription for an app

`POST /partner/app/{appId}/subscription`

This API endpoint enables partners to subscribe to WhatsApp  events (webhooks) for their partner application. When subscribed, WhatsApp will send real-time event notifications to the specified webhook URL for various event types like incoming messages, message status updates, user interactions, and more. This is essential for building interactive WhatsApp Business applications.

## Path parameters

- `appId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- SubscriptionAppSuccess
  - `status` string
  - `subscription` Subscription
    - `active` boolean
    - `appId` string
    - `createdOn` integer
    - `id` string
    - `mode` integer
    - `modifiedOn` integer
    - `showOnUI` boolean
    - `tag` string
    - `url` string
    - `version` integer

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - no permissions to access resource
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/gupshup/apis/partner-portal-public-apis.md) · [All operations](https://skmtc.net/gupshup/apis/partner-portal-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupshup/partner-portal-public-apis/revisions/1846573c8f87/schema)