Troubleshooting
If requests fail, run zero doctor check-connector --env-name PUSHINATOR_TOKEN or zero doctor check-connector --url https://api.pushinator.com/api/v2/notifications/send --method POST
How to Use
Base URL: https://api.pushinator.com
Required headers:
Authorization: Bearer $PUSHINATOR_TOKENContent-Type: application/json
1. Send a Push Notification
Send a notification to all subscribers of a channel.
Write to /tmp/pushinator_request.json:
{
"channel_id": "<your-channel-uuid>",
"content": "Hello from Pushinator!"
}Replace <your-channel-uuid> with your actual channel UUID, then run:
curl -s -X POST "https://api.pushinator.com/api/v2/notifications/send" \
--header "Authorization: Bearer $PUSHINATOR_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/pushinator_request.jsonResponse:
{
"success": true,
"message": "Notification created and being sent to subscribers"
}2. Send Deployment Notification
Notify when a deployment completes.
Write to /tmp/pushinator_request.json:
{
"channel_id": "<your-channel-uuid>",
"content": "Deployment complete! Project deployed to production."
}Replace <your-channel-uuid> with your actual channel UUID, then run:
curl -s -X POST "https://api.pushinator.com/api/v2/notifications/send" \
--header "Authorization: Bearer $PUSHINATOR_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/pushinator_request.json3. Send Alert with Emoji
Include emojis for visual distinction.
Write to /tmp/pushinator_request.json:
{
"channel_id": "<your-channel-uuid>",
"content": "Build failed! Check the CI logs."
}Replace <your-channel-uuid> with your actual channel UUID, then run:
curl -s -X POST "https://api.pushinator.com/api/v2/notifications/send" \
--header "Authorization: Bearer $PUSHINATOR_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/pushinator_request.jsonRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channel_id | string | Yes | UUID of the notification channel |
content | string | Yes | Notification message text |
HTTP Status Codes
| Code | Description |
|---|---|
| 2xx | Success - notification sent |
| 4xx | Invalid request or missing parameters |
| 5xx | Server error - retry recommended |
Guidelines
- Keep messages concise: Push notifications have limited display space
- Use channels for topics: Create separate channels for different notification types
- Rate limiting: Stay within your plan's monthly notification limit
- Include context: Make notifications actionable with relevant details