Error: Unable To Connect to API

Issue

While setting up a Jira connection, one of the following errors appears:

• Unable to connect to API. HTTP 403 Forbidden.
• Unable to connect to API. Setup test failed with "javax.ws.rs.ProcessingException: java.net.ConnectException: Connection timed out".
• Unable to connect to API. Not authorized

Environment

Connector: Jira

Resolution

To troubleshoot this issue, identify the error and follow the relevant steps.

HTTP 403 Forbidden

This error occurs when you haven't safelisted all applicable Fivetran IP addresses for your provider, region, and location in Jira.

To resolve this issue:

1. See our IP addresses documentation and note the applicable IP addresses for your provider, region, and location.
2. In Jira, create or edit an allowlist and add the applicable IP addresses. For more information, see the Atlassian documentation on specifying IP addresses.

Connection timed out

This error occurs when the Host or Port value is incorrect, or when Fivetran can't reach your Jira instance.

To resolve this issue:

1. In Fivetran, go to your Jira connection page.
2. Select the Setup tab.
3. Click Edit connection.
4. Update the connection settings:
   • For Jira Cloud, make sure the Host value ends with atlassian.net and the Port is 443.
   • For Jira Server or Jira Data Center, make sure the Host value uses a valid domain, such as jira.example.com, and the On Premise toggle is set to ON.
5. Click Save & Test.

If your Jira instance restricts network access, safelist the required Fivetran IP addresses or proxy URLs.

Not authorized

This error occurs when the Host value is invalid or when the connection uses an unsupported authentication method. Jira Server and Jira Data Center don't support OAuth 2.0 for API authentication.

To resolve this issue:

1. In Fivetran, go to your Jira connection page.
2. Select the Setup tab.
3. Click Edit connection.
4. Make sure the Host value ends with either atlassian.net or your Jira Server or Jira Data Center domain, such as jira.example.com.
5. Remove any extra dashes, symbols, or characters after the host domain.
6. If you're connecting to Jira Server or Jira Data Center:
   • Under Authentication Type, select Basic.
   • Enter your Jira username and password.
7. Verify that the authenticating user has sufficient permissions for the entities you want to sync.
8. If your Jira instance restricts network access, safelist the required Fivetran proxy URLs.
9. Click Save & Test.