Developers · Guides
Migrating data into Bookare
Bring members, their packs, bookings and history over from another system, safely and repeatably.
Moving a gym or studio from another system needs four things: the members, the packs they have now (with classes used and expiry), upcoming bookings, and past attendance. The import endpoints take them in batches of up to 100 rows.
Venue owners can do the same from the admin with CSV files (Settings → Data import); this page is for doing it from code.
Rules that make it safe
- Nothing is emailed to members during an import.
- Repeatable: every row carries your system’s
external_id. Sending the same row again changes nothing (existing), so a failed run can simply be run again. - Per-row results: each call answers how many were
created,existing, and theerrorswith the row number and why. - Packs and bookings point to members by your
member_external_id(ormember_email); bookings point to packs bypack_external_id. - Imported bookings never charge a pack a second time: the pack’s
classes_usedis the truth. They are linked to the pack, so a later cancellation returns the class.
Order
POST /admin/import/members{ "members": [ { "external_id", "name", "email", "phone", "joined", "status", "wants_news", "groups" } ] }POST /admin/import/packs{ "packs": [ { "external_id", "member_external_id", "name", "classes" | "unlimited", "classes_used", "starts", "expires", "price_eur", "paid", "paid_on", "method" } ] }POST /admin/import/bookings{ "bookings": [ { "external_id", "member_external_id", "date", "time", "class_type", "status", "pack_external_id" } ] }Past classes that do not exist are created; upcoming ones must already be on the timetable.POST /admin/import/visitsfor drop-in check-ins (open gym), one per member, class type and day.GET /admin/importto see what has been brought over.
Set up the class types and the weekly timetable first, so that upcoming bookings find their classes. A ready-made setup
(POST /admin/templates/{id}/apply) is a quick start.
The exact fields and their formats are in the Admin API reference.
Plan limits
Imported members who joined more than 90 days ago do not count towards the free plan’s member limit, so a venue can bring its whole history over and still try Bookare.