# Create Live Activity Notification
​
`POST https://onesignal.com/api/v1/apps/{app_id}/live_activities/{activity_id}/notifications`
​
The Create Live Activity Notification endpoint is use OneSignal to update a Live
Activity on a user's device.

​
## Required URL Path Params

|Parameter|Type|Description|
|--------|---|---|
|`app_id`|string|Your OneSigal App ID|
|`activity_id`|string|A self-generated value used to identify your Live Activity and associate devices to the event. You also provide this value to the iOS SDK method, `enterLiveActivity` (learn more [here](https://documentation.onesignal.com/docs/how-to-send-a-live-activity#activity-id)).|

## Required Headers

Basic authorization. Your OneSignal App's REST API Key, available in [Keys & IDs](https://documentation.onesignal.com/docs/accounts-and-keys).

## Required Body Parameters
​
| Parameter | Type | Description |
| --------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| `event` | string | Must be either `update` or `end` |
| `event_updates` | object | This must match the ContentState interface you have defined within your Live Activity in your app. |
| `name` | string | An internal name to assist with your campaign organization. This does not get displayed on the message itself. |

​
## Optional Body Parameters
​
If the following optional parameters are passed, an alert notification will be displayed on the users's watch.
​
| Parameter | Type | Description |
| ---------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `contents` | object | The notification's content (excluding the title). English must be included in the hash. Example: `{"en": "English Message"}`. |
| `headings` | object | The notification's title. English must be included in the hash. Example: `{"en": "English Message"}`. |
| `sound` | string | Sound file that is included in your app to play instead of the default device notification sound. Omit to disable vibration and sound for the notification. |

### Example cURL request​

curl --request POST \
    --url https://onesignal.com/api/v1/apps/{app_id}/live_activities/{activity_id}/notifications \
    --header 'Authorization: Basic YOUR_REST_API_KEY' \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --data '
{
    "event": "update",
    "event_updates": {
      "message": "The content available to the Live Activity from the defined ContentState."
    },
    "name": "Internal OneSignal Notification Name"
}'