Skip to content
API Reference
/
notifications
/
Send notification

ibl-data-manager (3.59.0-ai-plus)

API for iblai

Download OpenAPI description
ibl.json
ibl.yaml
Languages
Servers
Mock server

https://docs.ibl.ai/_mock/apis/ibl/

https://base.manager.iblai.app/

ai-account

Operations

ai-analytics

Operations

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

features

Operations

media

Operations

notifications

Operations

Preview notification

Request

Preview notification recipients and get build ID for sending

Security
PlatformApiKeyAuthentication
Path
platform_keystringrequired
Body
required
template_idstring or null(uuid)

Use a predefined template in the system

template_dataobject or null

Specify this to send a new custom message without using a predefined template

channelsArray of integersrequired

Specify the channel ids to send notifications to.

sourcesArray of objects(NotificationSource)required

Specify the sources to send notifications to

sources[].​typestring(NotificationSourceTypeEnum)required
  • email - email
  • username - username
  • platform - platform
  • csv - csv
  • department - department
  • pathway - pathway
  • program - program
Enum"email""username""platform""csv""department""pathway""program"
sources[].​dataany or nullrequired
contextobject

Specify the context that would be available in the message text

process_onstring or null(date-time)

(ISO datetime) Specify the date and time of processing this notification. Note, notifications are sent hourly and only scheduled messages prior to the beginning of the hour would be sent

curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/notification/v1/orgs/{platform_key}/notification-builder/preview/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
    "template_data": {
      "message_title": "",
      "message_body": "string"
    },
    "channels": [
      0
    ],
    "sources": [
      {
        "type": "email",
        "data": null
      }
    ],
    "context": {
      "property1": null,
      "property2": null
    },
    "process_on": "2019-08-24T14:15:22Z"
  }'

Responses

Bodyapplication/json
statusstringrequired
build_idstring(uuid)required
countintegerrequired
warningstring or nullrequired
recipientsArray of objects(Recipient)required
recipients[].​usernamestringrequired
recipients[].​emailstring(email)required
recipients[].​statusstring
Default "pending"
Response
application/json
{
  "status": "string",
  "build_id": "bfb1f3fa-bf7b-43a5-9e0b-26cc050e44cb",
  "count": 0,
  "warning": "string",
  "recipients": [
    { … }
  ]
}

Send notification

Request

Send notifications to all recipients in a build

Security
PlatformApiKeyAuthentication
Path
platform_keystringrequired
Body
required
build_idstringrequired
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/notification/v1/orgs/{platform_key}/notification-builder/send/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "build_id": "string"
  }'

Responses

Bodyapplication/json
statusstringrequired
notifications_sentintegerrequired
build_idstring(uuid)required
messagestringrequired
Response
application/json
{
  "status": "string",
  "notifications_sent": 0,
  "build_id": "bfb1f3fa-bf7b-43a5-9e0b-26cc050e44cb",
  "message": "string"
}

Validate notification source

Request

Validate a single notification source (email, username, platform, csv)

Security
PlatformApiKeyAuthentication
Path
platform_keystringrequired
Body
required
typestring(NotificationSourceTypeEnum)required
  • email - email
  • username - username
  • platform - platform
  • csv - csv
  • department - department
  • pathway - pathway
  • program - program
Enum"email""username""platform""csv""department""pathway""program"
dataany or nullrequired
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/notification/v1/orgs/{platform_key}/notification-builder/validate_source/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "email",
    "data": null
  }'

Responses

Bodyapplication/json
statusstringrequired
valid_countintegerrequired
invalid_entriesArray of stringsrequired
sample_recipientsArray of objects(Recipient)required
sample_recipients[].​usernamestringrequired
sample_recipients[].​emailstring(email)required
sample_recipients[].​statusstring
Default "pending"
Response
application/json
{
  "status": "string",
  "valid_count": 0,
  "invalid_entries": [
    "string"
  ],
  "sample_recipients": [
    { … }
  ]
}

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com