Provision a crew member into a sponsored seat
Auto-provision the account+vessel and grant Premium in one call (JIT).
Authorizations
OAuth 2.0 Authorization Code flow with PKCE. See the integration guide at docs.digitalseaservice.com for the full step-by-step.
Body
Auto-provision one crew member into a sponsored Premium seat (JIT).
All of email, first_name, last_name, position and a 7-digit
vessel_imo are required — the dashboard needs them to create the account,
vessel and tracking in one step. There is no invite/claim round-trip.
Crew member's email (normalised).
3Crew member's first name.
1 - 100Crew member's last name.
1 - 100Crew rank/role for the account.
17-digit IMO of the vessel to track.
^\d{7}$Crew member's phone (E.164).
Vessel display name (optional).
Crew join date on the vessel.
Partner's own opaque reference.
Response
Idempotent replay — an open seat already existed for this email.
The provisioned seat — returned 201 on create, 200 on idempotent replay.
The member's DSS user id — the same id delivered in the data.user_id of user.sea_time.updated webhooks. Persist it to correlate future webhooks to your own member record. Null until the seat is active (e.g. an invited-but-unclaimed seat).
False when the IMO did not match a vessel (soft failure).
Always null for JIT — there is no claim link.
Per-user sponsored term end (activated_at + term_months).

