Skip to content
Get started
2xxx — Resource Errors

2022: Contact card setup failed

The contact card was saved but could not be applied to the line, so it is not live yet.

The contact card was saved but could not be applied to the line. This is an HTTP 500 error returned by POST and PATCH /v3/contact_card when the card is stored against your account but does not reach the device, or cannot be activated afterwards.

The values you sent are kept. The card is left in a “requested, not live” state rather than being reverted, so retrying resends what you last asked for — you do not need to rebuild the request.

  • Retry the same POST or PATCH /v3/contact_card call after a few seconds — this is a transient failure, not a bad request
  • Check GET /v3/contact_card to confirm the state: the card exists with your requested values but is not active until a retry succeeds
  • On an update, the previous card is not being served either while setup is incomplete, so sharing stays unavailable until a retry succeeds
  • If it persists across several attempts, contact support with the trace_id from the error response