Netcore Cloud Trigger API

Trigger API from Netcore Cloud.

Operations 1

POST /trigger/publish Publish Trigger - APN #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/netcorecloud:netcore-cloud-trigger-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

netcorecloud-trigger-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Trigger API
  description: ''
  version: 1.0.0
servers:
- url: https://netcoreapi-main-prod-us.netcorein.com/v5/
  description: US
- url: ' https://netcoreapi-main-prod-ind.netcorein.com/v5/'
  description: IND
- url: ' https://netcoreapi-main-prod-eu.netcorein.com/v5/'
  description: EU
security:
- ApiKeyAuth: []
tags:
- name: Trigger
paths:
  /trigger/publish:
    post:
      summary: Publish Trigger - APN
      deprecated: false
      description: Use this endpoint to publish push notifications via APN to targeted app users. This API supports both real-time and scheduled notifications and allows callback configuration for delivery status updates.
      tags:
      - Trigger
      parameters:
      - name: api-key
        in: header
        description: API key for authentication. You must have a unique and valid API key.
        required: true
        example: 6a8f3c1b9d2e4f7a123b456c7890abcd
        schema:
          type: string
      - name: Content-Type
        in: header
        description: Specify the request content type. It must be application/json
        required: true
        example: application/json
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    triggers:
                      type: array
                      items:
                        type: object
                        properties:
                          tags:
                            type: array
                            description: 'A set of labels or identifiers that help categorize and filter the trigger event. Tags can be used for reporting, analytics, or downstream segmentation logic.


                              Usage Guideline:


                              You may pass up to 15 tags in a single trigger.

                              Each tags should be a string with a maximum length of 75 characters.

                              Tags should be meaningful identifiers like ''product_launch'', ''flash_sale'', or ''user_engagement''.'
                            items:
                              type: string
                          channel:
                            type: string
                            description: 'Channel name to send through: APN'
                            maxLength: 20
                            enum:
                            - apn
                          channel_config:
                            type: object
                            properties:
                              app_ids:
                                type: array
                                items:
                                  type: string
                                  description: 'Represents a single App ID entry used to route push notifications to the correct mobile application. Each string identifies a pre-registered app(Android or iOS). Allowed characters: Alphanumeric, dashes(-), and underscores(_).'
                                  maxLength: 50
                                  minItems: 1
                                  title: APP ID
                                description: Specifies the App IDs to which the notification should be delivered. Each App ID represents a registered application (iOS or Android) on which the push message should appear. This helps route the message to the correct app instance across platforms.
                                maxItems: 50
                                minItems: 1
                                title: App ID's
                              ttl:
                                type: integer
                                description: TTL(Time to Live) defines how long(in seconds) the notification should be retained for delivery if the target device is offline. The actual behavior on TTL expiry depeends on the underlying delivery system.
                                maximum: 2419200
                                title: TTL in seconds
                            required:
                            - app_ids
                            - ttl
                            description: Channel-specific configuration like App IDs
                          content:
                            type: object
                            properties:
                              template_type:
                                type: string
                                description: The message template format. Only 'Simple' is supported as per current API spec.
                                maxLength: 10
                                enum:
                                - Simple
                              landing_page_type:
                                type: string
                                description: Specifies the redirection behavior on click. Determines whether users land on the app homepage, a deep link, or an external URL.
                                enum:
                                - home
                                - deeplink
                                - url
                                title: ''
                                maxLength: 10
                              landing_page_url:
                                type: string
                                format: uri
                                description: The URL or deep link to open when the user taps the notification.
                              title:
                                type: string
                                maxLength: 100
                                description: The title text shown in the push notification. This is labeled as “APN Title” in the schema. Either 'title' or 'description' must be provided — at least one of the two is required. If description is omitted, 'title' becomes mandatory, and vice versa.
                                title: APN Title
                              description:
                                type: string
                                maxLength: 1000
                                description: Body text shown in the push message. Either 'title' or 'description' must be provided. The schema does not enforce mutual exclusivity, but documentation and logic should enforce that at least one is present.
                              os:
                                type: array
                                description: 'OS-specific metadata. One object per platform: Android and/or iOS.'
                                items:
                                  type: object
                                  properties:
                                    os_name:
                                      type: string
                                      description: Specifies the operating system to which this push content configuration applies. This is a required field within each object in the 'os' array. Only 'android' and 'ios' are accepted values.
                                      enum:
                                      - android
                                      - ios
                                      maxLength: 10
                                    subtitle:
                                      type: string
                                      description: Optional subtitle text to be displayed in the push notification. This can be used to supplement the title with additional context or highlight.
                                      maxLength: 30
                                      title: APN Subtitle
                                  required:
                                  - os_name
                                minItems: 1
                                maxItems: 2
                                title: OS
                            required:
                            - template_type
                            - landing_page_type
                            - landing_page_url
                            - os
                            description: Defines the message content for the push notification, including template type, landing behavior, OS-specific elements, title, and description.
                          audience_details:
                            type: object
                            properties:
                              contact_type:
                                type: string
                                description: Defines the category of the recipient. Use 'contact_master' for unified contact profiles, 'identified' for known identities (e.g., mobile/email), and 'anonymous' for temporary identifiers.
                                enum:
                                - contact_master
                                - identified
                                - anonymous
                              contact_attribute:
                                type: string
                                description: The attribute type used to identify the user (For example, 'identity', 'token'). This must align with the contact type selected.
                              attribute_value:
                                type: array
                                description: The values corresponding to the selected contact attribute. This is typically a list of identities like phone numbers, email addresses, or tokens.
                                items:
                                  type: string
                            required:
                            - contact_type
                            - contact_attribute
                            - attribute_value
                            description: Contains details about the target audience for the notification. You must specify the type of contact, the attribute used for identification, and the values for that attribute.
                          schedule_details:
                            type: object
                            description: Specifies when the notification should be sent. If omitted, the message is assumed to be sent immediately.
                            properties:
                              schedule_type:
                                type: string
                                description: Indicates the schedule behavior. Common values may include now or a datetime-based strategy. Specific allowed values are not defined in the schema but should be agreed upon with your backend system. This is madatory only if 'schedule_details' is present.
                            required:
                            - schedule_type
                        description: Trigger
                        required:
                        - channel
                        maxProperties: 1
                        minProperties: 1
                        title: Trigger Object
                      description: Trigger array of objects
                  required:
                  - triggers
                  description: Contains an arry of trigger objects.
                notify_callback:
                  type: object
                  properties:
                    callback:
                      type: array
                      items:
                        type: object
                        properties:
                          url:
                            type: string
                            description: Webhook URL
                          method:
                            type: string
                            description: HTTP Method
                            enum:
                            - GET
                            - POST
                            - DELETE
                          headers:
                            type: object
                            properties:
                              Content-Type:
                                type: string
                              Authorization:
                                type: string
                              <Custom-Key-Name>:
                                type: string
                              X-API-UUID:
                                type: string
                            required:
                            - Content-Type
                            - Authorization
                            - <Custom-Key-Name>
                            - X-API-UUID
                            description: Headers
                          body_params:
                            type: object
                            properties:
                              key:
                                type: string
                            required:
                            - key
                            description: Payload Body Object
                          query_params:
                            type: object
                            properties: {}
                            description: GET Query Params
                          webhook_id:
                            type: integer
                            description: Existing Webhook ID
                        required:
                        - body_params
                      description: Callback
                  required:
                  - callback
                  description: Notify and Callback
              required:
              - data
              - notify_callback
            example:
              data:
                triggers:
                - tags:
                  - Trigger
                  channel: apn
                  channel_config:
                    app_ids:
                    - android-app-id-1-1
                    - ios-app-id-1-2
                    ttl: 2800
                  content:
                    template_type: Simple
                    landing_page_type: home
                    landing_page_url: url
                    title: Title
                    description: Description
                    os:
                    - os_name: android
                      subtitle: Sub Title Text
                    - os_name: ios
                      subtitle: Sub Title Text
                  audience_details:
                    contact_type: identified
                    contact_attribute: identity
                    attribute_value:
                    - '1234567890'
                  schedule_details:
                    schedule_type: now
              notify_callback:
                callback:
                - url: https://www.webhook.com/test
                  method: POST
                  headers:
                    Content-Type: application/json
                    Authorization: Bearer <token>
                    <Custom-Key-Name>: <Custom-Key-Value>
                    X-API-UUID: <Client-UUID>
                  body_params: {}
                  query_params: {}
                - webhook_id: 1
                  body_params:
                    key: value
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                  code:
                    type: integer
                  status:
                    type: string
                  description:
                    type: string
                required:
                - request_id
                - code
                - status
                - description
              examples:
                '1':
                  summary: Publish Trigger - APN - Success
                  value:
                    request_id: a7add3e4-2206-49f6-927e-3dfd917b906a
                    code: 200
                    status: success
                    description: Your request was accepted successfully. It may take a few minutes to process your request.
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                  code:
                    type: integer
                  status:
                    type: string
                  description:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                required:
                - request_id
                - code
                - status
                - description
                - errors
              examples:
                '1':
                  summary: Publish Trigger - APN - Failed - Validation - Missing mandatory field
                  value:
                    request_id: 506611fa-1519-4624-94d2-5b59623de608
                    code: 400
                    status: failed
                    description: Validation Failure.
                    errors:
                    - field: data.triggers[0]
                      message: '"channel" Missing required field'
          headers: {}
        x-400:Publish Trigger - APN - Failed - Validation - Invalid Value Type:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                  code:
                    type: integer
                  status:
                    type: string
                  description:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                required:
                - request_id
                - code
                - status
                - description
                - errors
              examples:
                '1':
                  summary: Publish Trigger - APN - Failed - Validation - Invalid Value Type
                  value:
                    request_id: 506611fa-1519-4624-94d2-5b59623de608
                    code: 400
                    status: failed
                    description: Validation Failure.
                    errors:
                    - field: data.triggers[0].ttl
                      message: Invalid value type.
          headers: {}
        x-400:Publish Trigger - APN - Failed - Validation - Invalid Value:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                  code:
                    type: integer
                  status:
                    type: string
                  description:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                required:
                - request_id
                - code
                - status
                - description
                - errors
              examples:
                '1':
                  summary: Publish Trigger - APN - Failed - Validation - Invalid Value
                  value:
                    request_id: 506611fa-1519-4624-94d2-5b59623de608
                    code: 400
                    status: failed
                    description: Validation Failure.
                    errors:
                    - field: data.triggers[0].content.os[0].os_name
                      message: Invalid value type.
          headers: {}
        x-200:Publish Trigger - APN - Success:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                  code:
                    type: integer
                  status:
                    type: string
                  description:
                    type: string
                required:
                - request_id
                - code
                - status
                - description
              examples:
                '1':
                  summary: Publish Trigger - APN - Success
                  value:
                    request_id: a7add3e4-2206-49f6-927e-3dfd917b906a
                    code: 200
                    status: success
                    description: Your request was accepted successfully. It may take a few minutes to process your request.
          headers: {}
      security:
      - ApiKeyAuth: []
      operationId: postTriggerPublish
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: "API key needed to access the endpoints. \nExample: `5evddf6604d2845b3b27023e5c2716f1`"
      x-default: 5evddf6604d2845b3b27023e5c2716f1
x-provenance:
  method: searched
  source: https://developer.netcorecloud.com/reference
  note: Verbatim OpenAPI fragments embedded in each ReadMe reference page on developer.netcorecloud.com, merged by path. Not authored by API Evangelist.
  retrieved: '2026-10-13'