API

Create reminder

Creates a new reminder for a company.

POST/v1/hq/reminders
AuthorizationBearer <token>

The Noona HQ API uses Bearer token for authentication.

Endpoints that return generic information that does not contain sensitive data do not require authentication. Endpoints that require authentication are specifically marked in the documentation.

Authorization: Bearer your-token

In: header

Query Parameters

select?array<string>
expand?array<string>

Request Body

application/json

title?string
Example"Lunch reminder"
company_id*string

Company ID

Example"cmp123"
employees?array<string>

Employee IDs for employee-specific reminders

event_types?array<string>

Event type IDs for event-specific reminders

minutes_before*integer

How many minutes before the event to send the reminder

Formatint32
Example1440
notification_channels*array<NotificationChannel>

Channels through which the reminder should be sent

sms_content_translations?

A map of translations for a given attribute.

The key is the language code, and the value is the translated string.

Example{ "is": "King Accounting tenging", "fr": "Connexion King Accounting" }
active?boolean

Whether the reminder is active or inactive. Defaults to true if not provided.

Defaulttrue

Response Body

application/json

application/json

curl -X POST "https://api.noona.is/v1/hq/reminders" \  -H "Content-Type: application/json" \  -d '{    "company_id": "cmp123",    "minutes_before": 1440,    "notification_channels": [      "hq"    ]  }'
{
  "id": "8wa9uiah28dawd123",
  "title": "Lunch reminder",
  "company": "string",
  "employees": [
    "emp123",
    "emp456"
  ],
  "event_types": [
    "svc123",
    "svc456"
  ],
  "minutes_before": 1440,
  "notification_channels": [
    "sms"
  ],
  "sms_content": "Hi {{customer_name}}, this is a reminder that {{employee_name}} will see you at {{event_time}} at {{company_name}}",
  "sms_content_translations": {
    "is": "King Accounting tenging",
    "fr": "Connexion King Accounting"
  },
  "default": true,
  "active": true,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}
{
  "type": "validation",
  "message": "string",
  "user_message": "A global reminder with this time period already exists"
}
Empty
Empty