Quick answer: If your venue already keeps its events in a website, a booking system or a spreadsheet, the Balievents Host API lets that system create, update and delete your Balievents listings and read your guest lists, so nobody types the same night twice. Keys are issued on request: write to marketing@balievents.co from your host account's email. The full documentation is in the API tab of your host dashboard.
Fast facts — from the Balievents host dashboard:
Why sync events instead of typing them in?
A venue with a weekly programme — a beach club in Canggu with a DJ every night, a studio in Ubud with a dozen classes, a bar in Seminyak with quiz, comedy and live music — changes it every week. Typing each change into every listing site is where mistakes come from: the old time on one page, the cancelled night still bookable on another.
With the API, your own system stays the one place you edit. When a night is added, moved or dropped there, it changes on Balievents too.
What can the Host API do?
| Request | What it does |
|---|---|
| GET /events | Lists your events, up to 100 per page |
| GET /events/:id | One of your events |
| POST /events | Creates an event; title and date are required |
| PATCH /events/:id | Changes fields on one of your events |
| DELETE /events/:id | Deletes one of your events |
| GET /events/:id/guests | The guest list of one event, with check-in status |
| GET /guests | Guests across all your events, up to 500 per page |
An event can carry a title, date and time, end time, venue and area, description, price, poster image, category tag, your Instagram and WhatsApp, and every date it runs.
Deleting an event that still has active bookings is refused, so a sync cannot wipe out a night people have booked by accident; the API asks you to confirm with ?force=true. Bookings stay in your sales history either way.
How do I get API access?
- Sign in and open API in your host dashboard. The documentation is there, so you can plan the integration first.
- Write to marketing@balievents.co from your host account's email: what you want to build and how many requests you expect. The API tab has a button that starts this email for you.
- Receive your key. It starts with be_live_ and appears in the API tab, where you can also revoke it.
How does a request look?
Every request goes to https://api.balievents.co/functions/v1/host-api from your server, with the key in the Authorization header as Bearer be_live_… or in an X-API-Key header.
- To list your events, send GET to /events, with limit and offset to page through them.
- To create an event, send POST to /events with a JSON body. Only title and date (as YYYY-MM-DD) are required; the time is 19:00 unless you send one, and start_dates lists every date a series runs.
- To change one, send PATCH to /events/ and its id, with only the fields that changed.
The API tab in your dashboard has a copy-ready example of every request.
Keep the key on your server. Never put it in a web page's JavaScript or a public repository; if it leaks, revoke it in the API tab and ask for a new one.
What still happens in the dashboard?
The API covers the listing and the guest list. Ticket types, capacity, your bank account, promoter links, promo codes and door scanning are set in the host dashboard, and they apply to events created through the API as well.
Paid tickets are sold on Balievents the same way as for any other event: card, QRIS, e-wallet or bank transfer, a 3% service fee paid by the guest, and a payout run every Friday. See how to sell tickets for an event in Bali.
What can I build with it?
- Your website as the source. Publish a night on your own site and it appears on Balievents.
- Guest lists in your own tools. Pull every booking's name, email, number of guests and check-in status into your CRM or newsletter. More on using that list: lead generation for Bali venues and event hosts.
- One programme for several venues. An agency or promoter that lists nights across Canggu, Seminyak and Uluwatu under one host account manages them all from its own system.
Need it built? Enterprise includes tech consultancy and CRM and custom integrations; ask on the partnership page.
Frequently asked questions
Does Balievents have an API for event listings?
Yes. The Host API creates, updates and deletes a host's events and reads their guest lists. Keys are issued on request through marketing@balievents.co.
How do I get a Balievents API key?
Write to marketing@balievents.co from your host account's email with what you want to build. The key then appears in the API tab of your dashboard.
Can the API see other hosts' events?
No. A key sees only its own host's events and guests; any other event returns not found.
Are events created through the API published immediately?
Yes. They are live on Balievents as soon as they are created.
Can I sell tickets for events created through the API?
Yes. Set the ticket types, capacity and bank account in the host dashboard; tickets are sold on Balievents like any other event's.
Does the API cost extra?
No. The same plans and fees apply as for events created in the dashboard.
How BaliEvents sources this guide
BaliEvents Editorial reviews live bookable listings and recurring community calendars across Canggu, Ubud, Seminyak, Uluwatu, Jimbaran, and Sanur. Endpoints, limits and access rules in this guide are the ones in the Balievents Host API and its documentation in the host dashboard on 24 October 2026. Features and rules change; check your host dashboard and the partnership page before you rely on one.
Updated October 2026.
