Invites

Create a single-use booking link

Mints a booking link that works once and then stops. Use it to reply to an enquiry. Works for public and invite-only event types, and the invitee skips the anti-spam checks because the link already proves you meant them. The url is returned only here.

post/invites

Request

  • Base URL: https://api.marubox.jp/v1
  • URL: https://api.marubox.jp/v1/invites
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replays the first response for a repeated request, so a retry after a timeout cannot create a second record. Any string up to 255 characters, scoped to your account and remembered for 24 hours. Sending the same key with a different body returns 409 idempotency_conflict. A key whose booking has since been cancelled is forgotten, so rebooking the same time with the same key books afresh rather than returning the cancellation.

Idempotency-Keystring

Replays the first response for a repeated request, so a retry after a timeout cannot create a second record. Any string up to 255 characters, scoped to your account and remembered for 24 hours. Sending the same key with a different body returns 409 idempotency_conflict. A key whose booking has since been cancelled is forgotten, so rebooking the same time with the same key books afresh rather than returning the cancellation.

Idempotency-Keystring

Replays the first response for a repeated request, so a retry after a timeout cannot create a second record. Any string up to 255 characters, scoped to your account and remembered for 24 hours. Sending the same key with a different body returns 409 idempotency_conflict. A key whose booking has since been cancelled is forgotten, so rebooking the same time with the same key books afresh rather than returning the cancellation.

Request body

eventTypeIdstring required
namestring
emailstring email
expiresInDaysinteger

Response

Default Response

idstring required
eventTypeIdstring required
urlstring nullable required
namestring nullable required
emailstring nullable required
expiresAtstring date-time required
usedAtstring date-time nullable required
bookingIdstring nullable required
createdAtstring date-time required

Changes