

# Connection states in EventBridge
<a name="eb-target-connection-states"></a>

Below are the connection statuses returned by EventBridge when creating or re-authorizing a connection.

For successful connections to public APIs, EventBridge returns a status of `AUTHORIZED`. For successful connections to private APIs, EventBridge returns a status of `ACTIVE`.

*Connectivity failures* refer to errors involving the network connectivity of the connection. Connectivity errors result in a connection status of `FAILED_CONNECTIVITY`. *Authorization failures* refer to errors involving the permissions specified for the connection. Authorization failures result in a status of `DEAUTHORIZED`.

For information on how to have EventBridge re-authorize the connection once you have updated it to address authorization or connectivity issues, see [Updating connections](eb-target-connection-edit.md).

EventBridge emits events when the state of a connection changes. For more information, see [Connection events](event-reference.md#event-reference-connections).

**Public APIs**


| Authorization method | Success | Connectivity failure | Authorization failure | 
| --- | --- | --- | --- | 
| Basic or API Key | `AUTHORIZED` | n/a | `DEAUTHORIZED` | 
| OAuth (public endpoint) | `AUTHORIZED` | n/a | `DEAUTHORIZED` | 
| OAuth (private endpoint) | `AUTHORIZED` | `FAILED_CONNECTIVITY` | `DEAUTHORIZED` | 

**Private APIs**


| Authorization method | Success | Connectivity failure | Authorization failure | 
| --- | --- | --- | --- | 
| Basic or API Key | `ACTIVE` | `FAILED_CONNECTIVITY` | `DEAUTHORIZED` | 
| OAuth (public endpoint) | `ACTIVE` | `FAILED_CONNECTIVITY` | `DEAUTHORIZED` | 
| OAuth (private endpoint) | `ACTIVE` | `FAILED_CONNECTIVITY` | `DEAUTHORIZED` | 

When you create a connection to a private API, there can be a delay of up to several minutes from when the connection is successfully created to when you can successfully make HTTPS calls to the private API. During this period:
+ Private OAuth connection will be in `AUTHORIZING` state, and will transition to `AUTHORIZED` when OAuth token exchange is successfully completed.
+ The connection will update to `ACTIVE` status, and EventBridge will retry any invocations from event buses or pipes.

If you are using the connection in an HTTP task within a Step Functions workflow, you can configure retries on `httpTimeoutExceptions` to retry any calls to the private API that happen during this period.