Add a client to the waiting list

curl --request POST \
  --url https://api.dialtu.com/api/v2/public/calendar/waitlist/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": 123,
  "phone": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "waitlist_id": 123,
  "service_ids": [
    123
  ],
  "service_names": [
    "<string>"
  ],
  "priority": 1,
  "preferred_professional_id": 123,
  "earliest_date": "<string>",
  "latest_date": "<string>",
  "time_preference": "<string>",
  "notes": "<string>"
}
'

import requests

url = "https://api.dialtu.com/api/v2/public/calendar/waitlist/entries"

payload = {
    "client_id": 123,
    "phone": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "waitlist_id": 123,
    "service_ids": [123],
    "service_names": ["<string>"],
    "priority": 1,
    "preferred_professional_id": 123,
    "earliest_date": "<string>",
    "latest_date": "<string>",
    "time_preference": "<string>",
    "notes": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    client_id: 123,
    phone: '<string>',
    first_name: '<string>',
    last_name: '<string>',
    email: '<string>',
    waitlist_id: 123,
    service_ids: [123],
    service_names: ['<string>'],
    priority: 1,
    preferred_professional_id: 123,
    earliest_date: '<string>',
    latest_date: '<string>',
    time_preference: '<string>',
    notes: '<string>'
  })
};

fetch('https://api.dialtu.com/api/v2/public/calendar/waitlist/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "client_id": 123,
    "client_created": true,
    "entries": [
      {
        "id": 123,
        "waitlist_id": 123,
        "client": {
          "id": 123,
          "first_name": "<string>",
          "last_name": "<string>",
          "phone": "<string>",
          "email": "<string>"
        },
        "service": {
          "id": 123,
          "name": "<string>"
        },
        "status": "<string>",
        "priority": 123,
        "source": "<string>",
        "created_at": "<string>",
        "position": 123,
        "queue_attempts": 0,
        "flagged_for_review": false,
        "snooze_until": "<string>",
        "queued_at": "<string>",
        "seat_expires_at": "<string>",
        "preferred_professional_id": 123,
        "preferred_professional_name": "<string>",
        "earliest_date": "<string>",
        "latest_date": "<string>",
        "preferred_time_windows": [
          "<string>"
        ],
        "notes": "",
        "days_waiting": 0,
        "resolved_at": "<string>",
        "resolution_reason": "<string>",
        "created": true
      }
    ]
  },
  "status": "success"
}

POST

api

public

calendar

waitlist

entries

Add a client to the waiting list

curl --request POST \
  --url https://api.dialtu.com/api/v2/public/calendar/waitlist/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": 123,
  "phone": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "waitlist_id": 123,
  "service_ids": [
    123
  ],
  "service_names": [
    "<string>"
  ],
  "priority": 1,
  "preferred_professional_id": 123,
  "earliest_date": "<string>",
  "latest_date": "<string>",
  "time_preference": "<string>",
  "notes": "<string>"
}
'

import requests

url = "https://api.dialtu.com/api/v2/public/calendar/waitlist/entries"

payload = {
    "client_id": 123,
    "phone": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "waitlist_id": 123,
    "service_ids": [123],
    "service_names": ["<string>"],
    "priority": 1,
    "preferred_professional_id": 123,
    "earliest_date": "<string>",
    "latest_date": "<string>",
    "time_preference": "<string>",
    "notes": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    client_id: 123,
    phone: '<string>',
    first_name: '<string>',
    last_name: '<string>',
    email: '<string>',
    waitlist_id: 123,
    service_ids: [123],
    service_names: ['<string>'],
    priority: 1,
    preferred_professional_id: 123,
    earliest_date: '<string>',
    latest_date: '<string>',
    time_preference: '<string>',
    notes: '<string>'
  })
};

fetch('https://api.dialtu.com/api/v2/public/calendar/waitlist/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "client_id": 123,
    "client_created": true,
    "entries": [
      {
        "id": 123,
        "waitlist_id": 123,
        "client": {
          "id": 123,
          "first_name": "<string>",
          "last_name": "<string>",
          "phone": "<string>",
          "email": "<string>"
        },
        "service": {
          "id": 123,
          "name": "<string>"
        },
        "status": "<string>",
        "priority": 123,
        "source": "<string>",
        "created_at": "<string>",
        "position": 123,
        "queue_attempts": 0,
        "flagged_for_review": false,
        "snooze_until": "<string>",
        "queued_at": "<string>",
        "seat_expires_at": "<string>",
        "preferred_professional_id": 123,
        "preferred_professional_name": "<string>",
        "earliest_date": "<string>",
        "latest_date": "<string>",
        "preferred_time_windows": [
          "<string>"
        ],
        "notes": "",
        "days_waiting": 0,
        "resolved_at": "<string>",
        "resolution_reason": "<string>",
        "created": true
      }
    ]
  },
  "status": "success"
}

Autorizaciones

Authorization

string

header

requerido

API key created in the dashboard under Settings → API Keys. Send it as Authorization: Bearer pk_....

Cuerpo

application/json

Body of POST /calendar/waitlist/entries.

Identify the client with EITHER client_id (a contact already in this workspace) OR phone (E.164; the contact is matched by phone or created with the given names/email). Name the services by service_ids or service_names. waitlist_id is optional: left out, each service is routed to the active list that contains it.

client_id

integer | null

An existing contact's id

phone

string | null

E.164 phone, e.g. +573001112233 (alternative to client_id)

first_name

string | null

Given name, used only when the contact is created.

Maximum string length: 100

last_name

string | null

Family name, used only when the contact is created.

Maximum string length: 100

string | null

Email, used only when the contact is created.

Maximum string length: 255

waitlist_id

integer | null

Target list; omitted → resolved per service

service_ids

integer[] | null

Services by id

service_names

string[] | null

Services by exact name (case-insensitive)

priority

integer | null

0 urgent, 1 high, 2 normal (default), 3 low

Rango requerido: 0 <= x <= 3

preferred_professional_id

integer | null

calendar_profile_id the client would rather wait for

earliest_date

string | null

YYYY-MM-DD

latest_date

string | null

YYYY-MM-DD

time_preference

string | null

any | morning | afternoon | evening

notes

string | null

Free text shown to the team on the entry.

Maximum string length: 2000

Respuesta

Response for POST /calendar/waitlist/entries (always 200 on success: the call is an upsert).

data

PublicWaitlistEntryCreateDataSchema · object

requerido

Upsert result.

Show child attributes

status

string

predeterminado:success

Always success.

Allowed value: "success"

Empezar

Guías

Endpoints

Add a client to the waiting list

Autorizaciones

Cuerpo

Respuesta