Hi ​@jmalfait 

Our public API doesn’t currently let you create appointment reasons. As you’ve shown in the screenshot, you can add/edit them in Settings → Diary → Appointment reasons (Admin).

What the API does support today:

• List reasons:

  GET https://api.dentally.co/v1/appointment_reasons?deleted=false
  

  This returns all active reasons. There isn’t a practitioner filter in the live API yet.
   

  {
    "appointment_reasons": i
      {
        "id": "430c6234-4f3d-424d-b1ea-a4d1bc728d36",
        "reason": "LUNCH",
        "colour": "#25B0E6",
        "exam": false,
        "hygiene": false,
        "deleted": false,
        "position": 49
      }
    ],
    "meta": { "total": 50, "page": 1 }
  }

   

I’m going to add your comment to our internal feature requests as we already have a related suggestion to add an enhancement and allow filtering by practitioner. This would let integrations show only the relevant reasons for the selected provider. 

Our team is working hard on the Dentally API and we have several enhancements in discovery and development. No timelines to share yet, but I’ll make sure to update this thread when there’s news. 

A few things you can do meanwhile:

• Create/manage reasons in the app, then have your integration read them via the endpoint above.

• If you need practitioner-specific choices, keep a mapping on your side (reason IDs practitioners) and filter client-side after fetching the full list.

• When creating appointments via API, pass the ID of an existing reason; for extra context use notes/metadata.

Hope this helps!