Create Tms Invitation
Create an invitation with a magic link to onboard a TMS account.
Returns an invitation object with a unique ID that serves as the magic link token. Share this link with the TMS account to begin the onboarding process. Once accepted, a TMS share agreement is automatically created to enable data sharing.
Note: If an active, accepted, or declined invitation already exists for the same tms_account_ref,
the invitation is refreshed (expiration extended, reactivated if declined) and returned with status
code 200 instead of 201.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
API model for creating a TMS account invitation
Your internal identifier for the TMS account. Use this to map Catena TMS accounts back to your system. This value will be returned in webhooks and redirect URLs.
Restrict which transportation management systems the TMS account can connect to. Useful if you only need data from specific TMSs. If omitted, all available TMSs are shown. Cannot be combined with exclude_tms.
Exclude specific transportation management systems from the ones shown to the TMS account. Useful if you want the TMS account to have access to every TMS except a few. Cannot be combined with limit_tms.
How long the invitation link remains valid (1-672 hours). Default is 24 hours.
1 <= x <= 672Response
Existing invitation refreshed (already exists for this tms_account_ref)
API model for reading a TMS account invitation
Unique invitation identifier
When the invitation was created
The magic link used to accept the invitation. Share this URL with the TMS account to begin onboarding.
The expiration date and time of the invitation
The number of hours the invitation is valid for.
The current status of the invitation (active, accepted, declined, expired, or deleted)
active, accepted, declined, expired, deleted Your internal identifier for the TMS account. Use this to map Catena TMS accounts back to your system.
Your organization ID requesting access to TMS account data
The slug of your organization
The date and time the invitation was accepted. Null if not accepted.
Identifier of who accepted the invitation on behalf of the TMS account. Null if not accepted.
The reason provided for declining the invitation. Null if invitation was not declined.
The date the invitation was declined. Null if invitation was not declined.
Restrict which transportation management systems the TMS account can connect to.
Exclude specific transportation management systems from the ones shown to the TMS account.
The Catena TMS account ID created after accepting the invitation. Null if invitation has not been accepted.