Skip to main content
An EventInvite grants a specific user access to an invite-only event. There is at most one invite per user per event (enforced by a unique (eventId, userId) constraint), so re-inviting a user is idempotent. Invites are managed by hosts and always reference a Sublay userId (never a foreign ID). Invite records are returned by the host-only invitee-list endpoint (Fetch Invitees).

EventInvite

PropertyTypeDescription
idstringUnique invite identifier (UUID).
eventIdstringThe event the user is invited to.
userIdstringThe invited user.
userUser | nullPopulated user object. Present on invitee-list reads.
invitedAtstringISO timestamp when the invite was created.
createdAtstringISO timestamp when the record was created.
updatedAtstringISO timestamp when the record was last updated.

Behavior

  • AddPOST /events/:eventId/invites with a userId. Host-only. Idempotent against the unique constraint. When the notifications bundle is present, the invitee receives an event-invite notification.
  • RemoveDELETE /events/:eventId/invites with a userId. Host-only. Removing an invite revokes the user’s access to an invite-only event and deletes their RSVP (decrementing the count).
  • Visibility tie-in — for an invite-visibility event, only users with an invite row (plus hosts) can see or RSVP to the event.