Skip to content

Send Notify External

Use this endpoint to send notification messages externally to members.

📘 Request URL

POST https://openapi.zwiz.app/zignal/api/external/notify

📥 Request Headers

NameTypeRequiredDescription
X-System-IdStringSystem ID you received from Home menu
X-Api-KeyStringHMAC-SHA256 token from Create Authentication Token
Content-TypeStringapplication/json

📥 Request Body

NameTypeRequiredDescription
receive_member_idsArray of StringMember IDs to send notifications to (get from Get Business Members)
sender_idStringID of the sender
sender_nameStringDisplay name of the sender
sender_picture_urlStringImage URL of the sender
notify_contentArray of ObjectList of content blocks to notify (text or image)
created_byStringCreator identifier

📘 notify_content Object

NameTypeRequiredDescription
typeStringContent type: text or image
textStringWhen type is textText to display
urlStringWhen type is imageImage URL

💡 Request Example

bash
curl --location 'https://openapi.zwiz.app/zignal/api/external/notify' \
--header 'X-System-Id: {example-system-id}' \
--header 'X-Api-Key: {generated-x-api-key}' \
--header 'Content-Type: application/json' \
--data '{
  "receive_member_ids": ["example-member-id"],
  "sender_id": "xxx",
  "sender_name": "xxx",
  "sender_picture_url": "xxx",
  "notify_content": [
    {
      "type": "text",
      "text": "test"
    },
    {
      "type": "image",
      "url": "https://Example.png"
    }
  ],
  "created_by": "xxx"
}'

📤 Response

json
{
  "status": "success",
  "message": "Notification sent successfully"
}