---
title: "POST /v1/Services/{ServiceSid}/Notifications"
method: POST
path: "/v1/Services/{ServiceSid}/Notifications"
tags: ["NotifyV1Notification"]
---

# POST /v1/Services/{ServiceSid}/Notifications

`POST /v1/Services/{ServiceSid}/Notifications`

## Path parameters

- `ServiceSid` string, required

## Response `201`

Created

- NotifyV1ServiceNotification
  - `sid` string, nullable — The unique string that we created to identify the Notification resource.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Notification resource.
  - `service_sid` string, nullable — The SID of the [Service](https://www.twilio.com/docs/notify/api/service-resource) the resource is associated with.
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `identities` string[], nullable — The list of `identity` values of the Users to notify. We will attempt to deliver notifications only to Bindings with an identity in this list.
  - `tags` string[], nullable — The tags that select the Bindings to notify. Notifications will be attempted only to Bindings that have all of the tags listed in this property.
  - `segments` string[], nullable — The list of Segments to notify. The [Segment](https://www.twilio.com/docs/notify/api/segment-resource) resource is deprecated. Use the `tags` property, instead.
  - `priority` 'high' | 'low' — The priority of the notification. Can be: `low` or `high` and the default is `high`. A value of `low` optimizes the client app's battery consumption; however, notifications may be delivered with unspecified delay. For FCM and GCM, `low` priority is the same as `Normal` priority. For APNS `low` priority is the same as `5`. A value of `high` sends the notification immediately, and can wake up a sleeping device. For FCM and GCM, `high` is the same as `High` priority. For APNS, `high` is a priority `10`. SMS does not support this property.
  - `ttl` integer — How long, in seconds, the notification is valid. Can be an integer between 0 and 2,419,200, which is 4 weeks, the default and the maximum supported time to live (TTL). Delivery should be attempted if the device is offline until the TTL elapses. Zero means that the notification delivery is attempted immediately, only once, and is not stored for future delivery. SMS does not support this property.
  - `title` string, nullable — The notification title. For FCM and GCM, this translates to the `data.twi_title` value. For APNS, this translates to the `aps.alert.title` value. SMS does not support this property. This field is not visible on iOS phones and tablets but appears on Apple Watch and Android devices.
  - `body` string, nullable — The notification text. For FCM and GCM, translates to `data.twi_body`. For APNS, translates to `aps.alert.body`. For SMS, translates to `body`. SMS requires either this `body` value, or `media_urls` attribute defined in the `sms` parameter of the notification.
  - `sound` string, nullable — The name of the sound to be played for the notification. For FCM and GCM, this Translates to `data.twi_sound`. For APNS, this translates to `aps.sound`. SMS does not support this property.
  - `action` string, nullable — The actions to display for the notification. For APNS, translates to the `aps.category` value. For GCM, translates to the `data.twi_action` value. For SMS, this parameter is not supported and is omitted from deliveries to those channels.
  - `data` unknown
  - `apn` unknown
  - `gcm` unknown
  - `fcm` unknown
  - `sms` unknown
  - `facebook_messenger` unknown
  - `alexa` unknown

---

[API](https://skmtc.net/twilio/apis/notify-v1.md) · [All operations](https://skmtc.net/twilio/apis/notify-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/notify-v1/revisions/2d30a1df6148/schema)