Bridge Error Codes

Response format

Errors are returned as application/problem+json:

{
  "title": "A template named in the onboarding override is missing values only the caller can provide",
  "status": 422,
  "detail": "A template named in the onboarding override is missing values only the caller can provide",
  "code": "BRIDGE_CONVERSATION_0604",
  "extra": {
    "templateId": "f0000040-0000-4000-8000-000000000040",
    "missingVariables": [{ "key": "delivery_date", "label": "Delivery date" }]
  },
  "instance": "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/conversations",
  "traceId": "Root=1-6702b8c4-3f1a2b4c5d6e7f8091a2b3c4"
}

Field	Meaning
`code`	The stable error code listed on this page. Branch on this field.
`title`	A human-readable message. It may be longer than the title shown in the tables below, so never match on it
`status`	The HTTP status code
`detail`	More detail about this occurrence, when available
`extra`	Machine-readable context for the error, such as the ids or keys involved, when available
`instance`	The request URL
`traceId`	Include it when you contact support

A request that does not match the request schema — a missing or unknown field, a wrong type, or a value over its length limit — returns 422 without a code. Its errors list holds one entry per problem, each with loc (where), msg (what) and type.

Brand Error Codes

Error codes for brand checks when creating a conversation.

Code	Title	Message
`BRIDGE_BRAND_0101`	Brand Required	The workspace has brands enabled; each external participant must resolve to a brand or a line

Returned as 400. Send a brandId or a providerChannelId for every external participant; extra.resources lists the participants that had neither.

Conversation Error Codes

Error codes for conversation operations.

Code	Title	Message
`BRIDGE_CONVERSATION_0001`	Conversation Not Found	The requested conversation was not found
`BRIDGE_CONVERSATION_0002`	Conversation Not In Workspace	The conversation does not belong to the specified workspace
`BRIDGE_CONVERSATION_0003`	Conversation With Same Participants Already Exists	An active conversation with the same participants already exists
`BRIDGE_CONVERSATION_0004`	Conversation Not Active	The conversation is inactive; no operations can be performed on it
`BRIDGE_CONVERSATION_0005`	Conversation Operation Failed	An error occurred while operating on the conversation
`BRIDGE_CONVERSATION_0006`	Conversation With Inconsistent State	The conversation is in an inconsistent state; contact support to resolve
`BRIDGE_CONVERSATION_0101`	Internal User Already In Conversation	The internal user is already a participant in this conversation
`BRIDGE_CONVERSATION_0102`	Internal User Not In Conversation	The internal user is not a participant in this conversation
`BRIDGE_CONVERSATION_0103`	External User Already In Conversation	The external user is already a participant in this conversation
`BRIDGE_CONVERSATION_0104`	External User Not In Conversation	The external user is not a participant in this conversation
`BRIDGE_CONVERSATION_0201`	External Participants Required	At least one external participant is required to operate in a conversation
`BRIDGE_CONVERSATION_0202`	Internal Participants Required	At least one internal participant is required to operate in a conversation
`BRIDGE_CONVERSATION_0203`	User Is Not Admin	The user is not an administrator of this conversation
`BRIDGE_CONVERSATION_0204`	Last Admin Removal Forbidden	The conversation must have at least one administrator
`BRIDGE_CONVERSATION_0205`	Min Internal Users Required	The conversation must have a minimum number of internal participants
`BRIDGE_CONVERSATION_0206`	Max Internal Participants Exceeded	The maximum number of internal participants for this conversation has been exceeded
`BRIDGE_CONVERSATION_0207`	Min External Participants Required	The conversation must have a minimum number of external participants
`BRIDGE_CONVERSATION_0208`	Max External Participants Exceeded	The maximum number of external participants for this conversation has been exceeded
`BRIDGE_CONVERSATION_0210`	Min Participants Required	The conversation must have a minimum number of participants
`BRIDGE_CONVERSATION_0211`	Max Participants Exceeded	The conversation must have a maximum number of participants
`BRIDGE_CONVERSATION_0212`	Max Initial Messages Exceeded	The maximum number of initial messages has been exceeded
`BRIDGE_CONVERSATION_0213`	Messages Not In Conversation	The messages must belong to the same conversation
`BRIDGE_CONVERSATION_0601`	Onboarding Template Not Found	A template named in the onboarding override does not exist
`BRIDGE_CONVERSATION_0602`	Onboarding Template Not In Workspace	A template named in the onboarding override belongs to another workspace
`BRIDGE_CONVERSATION_0603`	Onboarding Template Not Approved	A template named in the onboarding override is not approved for the line a participant will be reached on
`BRIDGE_CONVERSATION_0604`	Onboarding Template Missing Parameters	A template named in the onboarding override is missing values only the caller can provide
`BRIDGE_CONVERSATION_0605`	Onboarding Template Unknown Parameters	The onboarding override names parameters the template does not declare
`BRIDGE_CONVERSATION_0606`	Onboarding Template Parameters Not Supported	Parameters were sent for an onboarding template that is not a WhatsApp provider template
`BRIDGE_CONVERSATION_0607`	Onboarding Template Invalid Parameter Values	Parameter values for an onboarding template break a WhatsApp rule and would be rejected when sent
`BRIDGE_CONVERSATION_0608`	Onboarding Configured Template Requires Caller Input	A template in the workspace’s onboarding sequence needs values only the caller can provide; a workspace admin must change the onboarding sequence

BRIDGE_CONVERSATION_0601 returns 404, 0602 and 0603 return 400, and 0604 to 0608 return 422. See Onboarding template parameters for what each one carries in extra and how to fix it.

External User Error Codes

Error codes for external user (contact) operations.

Code	Title	Message
`BRIDGE_EXTERNAL_0001`	External User Not Found	The requested external user was not found
`BRIDGE_EXTERNAL_0002`	External User Already Exists	An external user with the same identification data already exists
`BRIDGE_EXTERNAL_0004`	External User Not In Workspace	One or more external users do not belong to the specified workspace
`BRIDGE_EXTERNAL_0005`	External User Without Configured Field	External user does not have configured field; check the workspace or external information settings
`BRIDGE_EXTERNAL_0007`	Cellphone Owned By Another Contact	The phone number is already an active identity of a different external user
`BRIDGE_EXTERNAL_0013`	Email Owned By Another Contact	The email address is already an active identity of a different external user
`BRIDGE_EXTERNAL_0101`	External User Operation Failed	An error occurred while operating on the external user

Internal User Error Codes

Error codes for internal user operations.

Code	Readable Title	Message
`BRIDGE_INTERNAL_0001`	Internal User Not Found	The internal user was not found
`BRIDGE_INTERNAL_0002`	Internal Users Not In Workspace	The provided internal users do not belong to the specified workspace
`BRIDGE_INTERNAL_0003`	Inactive Internal User	One or more internal users are inactive in the workspace; check the user status in the workspace settings
`BRIDGE_INTERNAL_0004`	Internal User Without Configured Field	Internal user does not have configured field; check the workspace or internal information settings
`BRIDGE_INTERNAL_0101`	Internal User Does Not Support Operation	The internal user does not support this operation

Provider Channel Error Codes

Error codes for provider channel operations.

Code	Readable Title	Message
`BRIDGE_PROVIDER_CHANNEL_0001`	Provider Channel Not Found	The provider channel was not found; verify the workspace has channels configured

When creating a conversation, this code is returned as 409 when no WhatsApp line is available for a Contact — for example, because the Contact’s line is still bound to another conversation — or when the providerChannelId you named is not available for that Contact.

Rate Limit Error Codes

Error codes returned when a workspace exceeds its request budget. See Rate limits for the budget, the headers and a client that paces itself.

Code	Title	Message
`BRIDGE_RATE_LIMIT_0001`	Too Many Requests	The workspace has exhausted its request budget for the current window

This is the only code that should be retried automatically, and only after the delay given in the Retry-After header. Authentication failures are not rate-limit errors and retrying them on a schedule will never succeed.

Template Error Codes

Error codes for template operations.

Code	Title	Message
`BRIDGE_TEMPLATE_0001`	Provider Template Not Found	No provider template found for the given workspace and name

Returned as 404 by GET .../templates/{templateId} when the id or name does not match a WhatsApp template in your workspace.

Workspace Error Codes

Error codes for workspace operations.

Code	Title	Message
`BRIDGE_WORKSPACE_0001`	Workspace Not Found	The requested workspace was not found
`BRIDGE_WORKSPACE_0002`	Workspace Not In Organization	The workspace does not belong to the specified organization
`BRIDGE_WORKSPACE_0003`	Workspace Without Available Provider Channels	The workspace has no provider channels available

​Bridge Error Codes

​Response format

​Brand Error Codes

​Conversation Error Codes

​External User Error Codes

​Internal User Error Codes

​Provider Channel Error Codes

​Rate Limit Error Codes

​Template Error Codes

​Workspace Error Codes

Bridge Error Codes

Response format

Brand Error Codes

Conversation Error Codes

External User Error Codes

Internal User Error Codes

Provider Channel Error Codes

Rate Limit Error Codes

Template Error Codes

Workspace Error Codes