---
title: "subscribes/unsubscribes/registers for apns push notifications"
method: POST
path: "/kkid/apns"
tags: ["KKid"]
---

# subscribes/unsubscribes/registers for apns push notifications

`POST /kkid/apns`

## Query parameters

- `kidUserId` integer, required
- `tool` 'register' | 'subscribe' | 'unsubscribe' | 'send', required
- `token` string
- `devicename` string
- `title` string
- `message` string
- `badge` integer
- `sound` string
- `section` 'Chores' | 'Chores-New' | 'Chores-Reminders' | 'Allowance' | 'Allowance-New' | 'WishList'
- `priority` 'passive' | 'active' | 'time-sensitive' | 'critical'

## Response `200`

search results matching criteria

- Success — Success
  - `success` boolean
  - `message` string

## Other responses

- `202` — Accepted- Access Granted but data flow did not complete due to an unknown error.
- `206` — No Data Returned
- `400` — bad input parameter
- `401` — Unauthorized- API credentials not supplied. Ensure you have passed proper Username and Password parameters
- `403` — Forbidden- User access is denied. API user either does not have access or has been banned/locked.
- `405` — Method Not Allowed- API user does not have access to use this method
- `412` — API Access Denied! Your API key is invalid, expired, or not supplied!

---

[API](https://skmtc.net/kumpeapps/apis/kumpeapps-api.md) · [All operations](https://skmtc.net/kumpeapps/apis/kumpeapps-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kumpeapps/kumpeapps-api/versions/0f0bb0e58cc2/schema)