> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pushctl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a notification

> Compose and send visible or data-only notifications from the Pushctl dashboard.

The dashboard sends immediately to up to 500 external user IDs. Each eligible installation for those users becomes a separate delivery.

<Steps>
  <Step title="Choose recipients">Open **Notifications** → **Send notification** and add one or more external user IDs.</Step>
  <Step title="Compose the payload">Provide a title, body, or JSON data object. At least one must be present.</Step>
  <Step title="Add behavior">Optionally add an HTTPS image URL and an action URL such as `myapp://orders/123`.</Step>
  <Step title="Review advanced options">Set priority, TTL, collapse ID, sound, badge, Android channel ID, or iOS category only when your app handles them.</Step>
  <Step title="Queue the notification">Select **Queue notification**. Fanout starts after validation.</Step>
</Steps>

## Advanced options

<AccordionGroup>
  <Accordion title="TTL">The lifetime in seconds, from `0` through `2419200` (28 days).</Accordion>
  <Accordion title="Priority">Use **High** for time-sensitive user-visible notifications. Use **Normal** for routine delivery.</Accordion>
  <Accordion title="Collapse ID">Replaces an older pending message with the same identifier where the provider supports collapse behavior. Maximum 64 characters.</Accordion>
  <Accordion title="Data-only messages">Leave title and body empty and provide a JSON data object. OS background-delivery rules still apply.</Accordion>
</AccordionGroup>

<Warning>
  The application must be active. A provider credential and an eligible registered installation are also required for delivery.
</Warning>