বিষয়বস্তুতে যান
ব্যবহারকারী গাইডসাপোর্ট ডেমো অনুরোধ করুন সাইন ইন করুন
Pushwoosh.com

Messaging API v2 overview

এই বিষয়বস্তু এখনও আপনার ভাষায় উপলব্ধ নয়।

Messaging API v2 is a single REST/JSON endpoint for creating outbound messages across every channel Pushwoosh supports:

  • Push: iOS, Android, Huawei, Baidu, macOS, Amazon, Windows, Safari, Chrome, Firefox, IE
  • Email
  • SMS
  • Telegram, Kakao, LINE, WhatsApp

Channel is selected by the payload type (payload for push / SMS / messengers, email_payload for email).

Targeting is selected by the request kind (segment for audience segments, transactional for explicit device or user lists).

Base URL

Anchor link to
https://api.pushwoosh.com

If you use a dedicated region or private deployment, confirm the exact base URL with your Pushwoosh Customer Success Manager.

Authentication

Anchor link to

Every request must include an Authorization header with a server-side Pushwoosh API access token:

Authorization: Token YOUR_API_TOKEN

Use the same token you already issue for server-to-server API calls. Do not expose this token in client applications.

Methods

Anchor link to
  • Notify: POST /messaging/v2/notify. Create and send a single message (segment or transactional).

Request and response format

Anchor link to
  • Content type: application/json.
  • Field names use snake_case. oneof groups appear as nested objects with exactly one key set.
  • Enum values are serialized as their string names (for example, "IOS", "MESSAGE_TYPE_MARKETING").
  • Successful responses return HTTP 200 with a JSON body; errors use the standard gRPC-Gateway error envelope — { "code": ..., "message": ..., "details": [...] }.

Quick start

Anchor link to
Send a push to a segment
curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "code": "active_users",
      "payload": {
        "content": {
          "localized_content": {
            "en": {
              "ios":     { "body": "Hello from v2!" },
              "android": { "body": "Hello from v2!" }
            }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'

Next steps

Anchor link to
Notify
Payload reference
Email payload reference
Migration from v1