When testing a custom action, you get an error message which indicates the domain or API endpoint is incorrect for the API request.
Causes
This error occurs because the custom action’s API endpoint URL is incorrect. Apps such as Glean, Workday, and Oracle Eloqua require the API endpoint URL to include a unique identifier specific to your organization. Custom actions cannot generate this identifier because these URLs are dynamic.
For example, Glean’s API requires the subdomain to be specified in the URL when making the API request.
How to fix it
- In your app’s API documentation, find the format required for an API endpoint.
-
Edit the code in your custom action.
- In the Custom Action Builder, in the left panel, click the Advanced tab.
- In the Code editor, find the API URL and adjust it according to the format the app expects.
- In the right panel, click Run test. Retesting the action should then allow your custom action to reach your domain with the expected endpoint URL.
Glean
API requests for Glean require a subdomain.
For example, if your Glean subdomain is mycompany-be, the API endpoint URL must contain the subdomain.
https://mycompany-be.glean.com/rest/api/v1/getdocuments.
For more information on Glean’s API, refer to their API documentation.
Workday
API requests for Workday require the tenantHostname and tenant.
For example, the tenantHouse is impl.wd12.myworkday.com and your tenant is mytenant. The API endpoint URL must contain the tenantHouse and tenant.
https://impl-services1.wd12.myworkday.com/ccx/api/v1/mytenant
The URL structure can also be represented more generally as:
https://<tenantHostname>/api/<serviceName>/<version>/<tenant>
You can find this information in the address bar after logging into Workday.
https://impl.wd12.myworkday.com/mytenant/d/home.htmld
For more information on Workday’s API, refer to:
Oracle Eloqua
API requests for Oracle Eloqua require a base URL.
For example, if your Oracle Eloqua base URL is https://secure.p03.eloqua.com, the API endpoint URL must contain the base URL.
https://secure.p03.eloqua.com/API/Rest/2.0?page=5&count=30
For more information on Oracle’s Eloqua’s API, refer to Oracle Eloqua’s API documentation.
NoteThe base URL is subject to change from time to time. If you notice that the Zap shows errors or the URL looks different when you log into your Oracle Eloqua account, you might need to update the API endpoint URL in your custom action.