Push Notification

Manage your push notification.

List an app push notification

get

Retrieve a collection of app push notification.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

countinteger · int64Optional

Total number of resource.

Example: 100

4XX

Error

get

/mobile_push

HTTPcURLJavaScriptPython

GET /api/mobile_push HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "app_name": null,
      "enabled": null
    }
  ]
}

Add App for enabling push notification

post

Mobile push messages wake up PortSIP Solutions Soft Phone or other Client Apps on mobile device so that a call or Instant Message can be accepted, reducing battery usage and improving reliability Android devices receive push notifications from Firebase Cloud Messaging Server; iOS devices receive push notifications from APNs.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

app_namestring · min: 1 · max: 64Optional

Application name.

enabledbooleanOptional

Enabled this notification or not.

Default: true

modestring · enumOptional

Connect to Apple/Google development push server or production push server:

• PRODUCTION: Connect to Apple/Google production push server.
• DEVELOPMENT: Connect to Apple/Google development push server.

Default: PRODUCTIONPossible values:

android_service_accountstringOptional

The Firebase Cloud Messaging service account JSON file.

ios_certificatestringOptional

Content of this APNs SSL certificate key file.

ios_private_keystringOptional

Content of this APNs SSL private key file.

Responses

201

Created push

application/json

4XX

Error

post

/mobile_push

HTTPcURLJavaScriptPython

POST /api/mobile_push HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "app_name": null,
  "enabled": null,
  "mode": null,
  "android_service_account": null,
  "ios_certificate": null,
  "ios_private_key": null
}

{
  "id": "xxxxxxxx"
}

Retrieve an app push notification.

get

Retrieve details of app push notification by it's unique ID.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

idstringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

app_namestring · min: 1 · max: 64Optional

Application name.

enabledbooleanOptional

Enabled this notification or not.

Default: true

modestring · enumOptional

Connect to Apple/Google development push server or production push server:

• PRODUCTION: Connect to Apple/Google production push server.
• DEVELOPMENT: Connect to Apple/Google development push server.

Default: PRODUCTIONPossible values:

android_service_accountstringOptional

The Firebase Cloud Messaging service account JSON file.

ios_certificatestringOptional

Content of this APNs SSL certificate key file.

ios_private_keystringOptional

Content of this APNs SSL private key file.

ios_cert_expire_atstring · date-timeOptional

The expiration date and time of the iOS push certificate.

Example: 2026-03-31T23:59:59Z

cert_remaining_daysintegerOptional

The remaining validity period of the iOS push certificate, in days. A positive value indicates the number of days until expiration, while a negative value indicates how many days the certificate has already been expired.

Example: 450

4XX

Error

get

/mobile_push/{id}

HTTPcURLJavaScriptPython

GET /api/mobile_push/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "app_name": null,
  "enabled": null,
  "mode": null,
  "android_service_account": null,
  "ios_certificate": null,
  "ios_private_key": null,
  "ios_cert_expire_at": "2026-03-31T23:59:59Z",
  "cert_remaining_days": 450
}

Update an app push notification

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

application/json

app_namestring · min: 1 · max: 64Optional

Application name.

enabledbooleanOptional

Enabled this notification or not.

Default: true

modestring · enumOptional

Connect to Apple/Google development push server or production push server:

• PRODUCTION: Connect to Apple/Google production push server.
• DEVELOPMENT: Connect to Apple/Google development push server.

Default: PRODUCTIONPossible values:

android_service_accountstringOptional

The Firebase Cloud Messaging service account JSON file.

ios_certificatestringOptional

Content of this APNs SSL certificate key file.

ios_private_keystringOptional

Content of this APNs SSL private key file.

Responses

200

OK

No content

4XX

Error

post

/mobile_push/{id}

HTTPcURLJavaScriptPython

POST /api/mobile_push/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "app_name": null,
  "enabled": null,
  "mode": null,
  "android_service_account": null,
  "ios_certificate": null,
  "ios_private_key": null,
  "ios_cert_expire_at": "2026-03-31T23:59:59Z",
  "cert_remaining_days": 450
}

No content

Delete an app push notification.

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

4XX

Error

post

/mobile_push/{id}/destroy

HTTPcURLJavaScriptPython

POST /api/mobile_push/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content