What happens if my carrier declines the invitation?
Handle declined invitations and resend access with the same fleet_ref.
If your carrier declines the magic link, you will receive an invitation.declined webhook event. The carrier is redirected to the failure URL you configured when creating the invitation.
A declined invitation can be re-sent. Call the Create Invitation API again with the same fleet_ref. Catena will reactivate the declined invitation, extend its expiration, and return a fresh magic link. There is no limit on how many times you can resend.
If a carrier repeatedly declines, it is usually worth reaching out directly to understand their concerns. Common reasons include not recognizing what Catena is, uncertainty about what data will be shared, or a preference to connect via a different process.
Note: Fleets can also revoke access after accepting by cancelling their share agreement. If that happens, you will receive a share_agreement.updated or share_agreement.deleted webhook event and data access will stop immediately.