Setup Custom Endpoints
A guide for creating, managing, and deleting custom endpoints to integrate external services or APIs into Genesis workflows.
Overview
Purpose
Setup Custom Endpoints provides a way to define and maintain connections to external APIs or services under distinct groups (e.g., “jira,” “slack,” or proprietary systems). This feature allows Genesis bots or workflows to communicate with any service by referencing these custom endpoints, simplifying integration and centralizing external API management.
Add Endpoints
Create new endpoint entries by specifying a group name (e.g., “jira”) and an API base URL.
Organize Endpoints
View, group, and manage external API links in a centralized interface.
Delete Groups
Cleanly remove no-longer-needed endpoint groups along with their URLs.
Use Cases
-
External API Integration
-
Seamlessly link to third-party services like Jira, Slack, or proprietary systems.
-
Example: A user adds a group named
"jira"
with the endpoint"https://yourcompany.atlassian.net"
for ticket management.
-
-
Workflow Automation
-
With endpoints in place, bots can fetch or post data to external services.
-
Example: A Slack integration group to send messages or announcements from a Genbot.
-
-
Dynamic Communication
-
Real-time data retrieval or push notifications to external APIs.
-
Example: Querying a weather API (group
"weather"
) then incorporating the results into daily updates.
-
-
Organization of Integrations
-
Grouping endpoints by name (e.g.,
"customerAPI"
,"analytics"
) to easily manage multiple external connections. -
Example: Large-scale project with various microservices all listed under separate group names.
-
IMPORTANT Double-check that no sensitive credentials appear in the endpoint URL. Use headers or secure tokens for authentication.
Workflow/How It Works
-
Step 1: Navigate to the Custom Endpoints Page
- Access the “Setup Custom Endpoints” area; locate “Add a New Endpoint,” “Endpoints by Group,” and “Delete Group.”
-
Step 2: Add a New Endpoint
-
Provide a group_name (e.g.,
"jira"
) and the endpoint_url (e.g.,"https://yourcompany.atlassian.net"
). -
Click “Add Endpoint.”
-
-
Step 3: Verify Endpoint
-
In the “Endpoints by Group” table, confirm your group name and URL are listed.
-
The columns might show “Group Name” and “Endpoints.”
-
-
Step 4: (Optional) Generate EAI
-
Some interfaces have a “Generate EAI” button to create usage instructions or identifiers.
-
Review the generated material to integrate your new endpoint in relevant workflows.
-
-
Step 5: Manage or Delete Endpoints
-
If needed, remove a group via the “Delete Group” dropdown and button.
-
To update an endpoint, typically delete the group and re-add with correct details.
-
-
Step 6: Use Endpoints in Workflows
-
Reference the group name or endpoint in automation steps to fetch/post data.
-
Example: Bot referencing the “jira” group to call “/rest/api/3/issue/” subpaths for ticket creation.
-
NOTE Group names should match the service (e.g., “slack”, “jira”) for simpler referencing in your logic or code.
Integration Relevance
-
ETL & Reporting: Connect to external data sources or push results to remote systems.
-
Project Tracking: E.g., a “jira” group for ticket operations, or “asana” for tasks.
-
Workflow Automation: Combine with existing tools to incorporate new, custom integrations with minimal overhead.
Configuration Details
-
API Authentication: Typically, you handle credentials (tokens, OAuth) in your workflow’s request headers—this tool focuses on the base URL.
-
Group Name: Reflect the service usage or domain for quick identification (e.g., “weatherAPI”, “analyticsService”).
-
Security: Endpoints might be behind authentication layers or proxies—ensure you handle tokens or keys in a secure manner.
Limitations or Notes
-
Endpoint URLs
- Must include
https://
for secure requests; incomplete or invalid URLs can fail.
- Must include
-
Manual Reconfiguration
- If an endpoint changes (like domain shifts), you must update or delete the old group and re-add the new details.
-
Generating EAI
- Instructions produced are typically generic; tailor them to your environment or workflow requirements.
Output
-
Endpoint Registration
- Confirmation message after adding or deleting a group/endpoint.
-
Group Table
- A list of endpoint groups and associated URLs for reference.
-
EAI Instructions
- If “Generate EAI” is used, documentation describing how to incorporate the new endpoint within your processes.
How It Works
By organizing external service URLs under specific group names, the system references “custom endpoints” in your automation. For instance, a group named "slack"
with an endpoint of "https://slack.com/api/"
allows your bots to easily form requests (https://slack.com/api/chat.postMessage
) without repeatedly specifying the entire base path.
Example
-
The user adds an endpoint group:
-
Group:
"jira"
-
Endpoint:
"https://yourcompany.atlassian.net"
-
-
Then, an internal workflow or bot references
"jira"
to constructGET /rest/api/3/search?jql=...
, appending it to the stored base URL.