Skip to content
view raw .md

Important dates

Read organization-scheduled important dates (holidays, out-of-office).

On this page
GET/v1/important-date/API keyCLI AuthPage-number pagination

List important dates

List important dates

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
curl -sS -X GET 'https://api.dailybot.com/v1/important-date/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Try it

This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.

GET/v1/important-date/{uuid}/API keyCLI Auth

Retrieve an important date

Retrieve an important date

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required—

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not found or not visible
curl -sS -X GET 'https://api.dailybot.com/v1/important-date/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Try it

This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.

Important dates

List and create important dates (birthdays, work anniversaries, and custom events) for organization members.

Endpoints summary

Method Endpoint Description
GET /v1/important-dates/ List important dates
GET /v1/important-dates/{id}/ Get a specific important date
POST /v1/important-dates/ Create an important date

GET /v1/important-dates/

Returns important dates for the organization, optionally filtered by user.

Query parameters

Name Type Required Description
user_uuid string (UUID) No User UUID whose dates to return.
date_type string No Filter by type: birthday, anniversary, or custom.
limit integer No Number of results. Default: 250.
offset integer No Pagination offset. 
curl -X GET "https://api.dailybot.com/v1/important-dates/?user_uuid=usr_abc123" \
  -H "X-API-KEY: your_api_key"

Response (200 OK):

{
  "count": 2,
  "results": [
    {
      "id": "date-uuid",
      "user": { "uuid": "usr_abc123", "name": "Jane Doe" },
      "date_type": "birthday",
      "date": "1990-03-15",
      "label": "Birthday"
    }
  ]
}

GET /v1/important-dates/{id}/

Returns a specific important date.

curl -X GET "https://api.dailybot.com/v1/important-dates/date-uuid/" \
  -H "X-API-KEY: your_api_key"

POST /v1/important-dates/

Creates a new important date for a user.

Body parameters

Name Type Required Description
user_uuid string (UUID) Yes UUID of the user.
date_type string Yes One of: birthday, anniversary, custom.
date string Yes Date in YYYY-MM-DD format.
label string No Custom label for the date. 
curl -X POST "https://api.dailybot.com/v1/important-dates/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "user_uuid": "usr_abc123",
    "date_type": "birthday",
    "date": "1990-03-15",
    "label": "Birthday"
  }'

Response (201 Created):

{
  "id": "date-uuid",
  "user": { "uuid": "usr_abc123", "name": "Jane Doe" },
  "date_type": "birthday",
  "date": "1990-03-15",
  "label": "Birthday"
}