Skip to main content
Connector guides

Connect Gorelo

Gorelo is a cloud RMM + PSA platform for MSPs — remote monitoring and management of endpoints alongside a ticketing/CRM system for clients, contacts, and alerts. Connecting Gorelo to StackJack lets…

Written By Christopher Scaminaci

Last updated About 4 hours ago

Gorelo is a cloud RMM + PSA platform for MSPs — remote monitoring and management of endpoints alongside a ticketing/CRM system for clients, contacts, and alerts. Connecting Gorelo to StackJack lets your AI assistant work with your Gorelo clients, contacts, RMM agents, and tickets through its public API.

Connecting Gorelo gives your AI a focused set of gorelo_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • Look up your clients (companies) and their locations, and the contacts (people) attached to them
  • Inventory your RMM agent devices and your custom (non-agent) assets, with full detail
  • Create, update, and delete clients and contacts
  • Raise alerts against a client
  • Work tickets end to end — list, read, open, update, and delete them, and read the ticket statuses, tags, and types needed to fill them in
  • Read and post ticket conversations — comments, side conversations, and approvals, including uploading a file to a ticket
  • Track time — list, read, log, amend, and delete time entries across tickets and tasks
  • Read billing setup — billing roles, work types, and contracts, and download an invoice PDF
  • Resolve your organization's own users and groups (technicians and teams) for ticket assignment

How StackJack authenticates to Gorelo

Gorelo uses an API key sent in the X-API-Key header on every request. Generate it from Settings → Integrations, open the API integration with the cog icon, and choose its permission scope. There is no OAuth or refresh-token flow. Gorelo's public API guide does not publish an automatic-expiration schedule, so plan an intentional replacement and revoke the old key when rotation is complete.

Per-key scopes matter. When you create a key in Gorelo you pick which areas it can touch — contacts, clients, assets, billing, time, alerts, tickets, organization. If a tool returns a 403, it means the key lacks that endpoint's scope, not that your whole account is blocked. Grant the key the areas your AI needs and the 403 goes away.

Regions

Gorelo is region-hosted. StackJack shows a Region dropdown — US (api.usw.gorelo.io) or AU (api.aue.gorelo.io) — that sets the host StackJack calls. Pick the region your Gorelo account lives in. The two regions expose the same tools; only the host differs.

Before you begin

  • In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
  • In Gorelo: you need admin access to Settings → Integrations to configure the API integration.
  • Know your region — US or AU, which you'll select in StackJack.

Step 1 — Create an API key in Gorelo

  1. Sign in to Gorelo as an admin and go to Settings → Integrations.
  2. Click the cog icon for API, then choose Generate New Key.
  3. Enter a descriptive name (for example, "StackJack Integration") and an optional description.
  4. Choose the permission scope the key should grant. Include at least Clients (read) so StackJack's save-time validation can list clients, plus the areas your AI will use.
  5. Click Generate and copy the key.

Step 2 — Add the credentials in StackJack

  1. In the StackJack portal, open Connectors.
  2. Select the Gorelo tile to open its details drawer.
  3. Use How To Connect to review the inline steps, then choose Configure in the drawer footer.
  4. Choose your Region (US or AU). The connection host is set from your choice.
  5. Paste your Gorelo API key and click Save.

What happens when you save

  • The API key is stored encrypted in Azure Key Vault — never in the StackJack database, and never shown back to you.
  • If this is the first time you configure Gorelo, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
  • StackJack immediately live-validates the key by listing clients. The credential remains saved if that upstream check fails so you can correct the region or scope without re-entering every field.
  • The Configure form collapses while the details drawer stays open. The drawer shows Connected and Valid after success, or Needs Attention with a Re-test action after failure.

Because validation reads your clients, the key needs at least the Clients (read) scope to validate cleanly. A key scoped only to ticket creation can still be valid for that purpose but will report a 403 during save-time validation.

Plans and available tools

See the generated Gorelo tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

Gorelo has no per-user sign-in for its API, so all AI traffic authenticates as the single API key — there is no per-user attribution. Current pricing and quotas are shown in the portal's Billing page and at checkout.

Deleting is real, and it is a soft delete. Gorelo's public API does expose delete operations, and StackJack surfaces them as clearly labeled destructive tools. Each one deactivates the record rather than erasing it, so history survives and the record disappears from lists. Two are worth knowing before you ask your AI for one: deleting a ticket also deletes its time entries, and deleting a client or contact is refused outright when other records still depend on it, telling you what is in the way instead of quietly detaching it. The Gorelo web app warns and proceeds in those cases; the API stops. Deleting something already deleted is safe to repeat.

What the Gorelo public API does not expose. There is no way to list or read your uptime checks — your AI can delete one by its ID, but it can only learn that ID from a ticket the check is linked to, or from the Gorelo web app.

Rate limits

Gorelo publishes no numeric API quota. StackJack applies a conservative per-tenant pace (about 120 requests per minute) and honors any 429 backoff, so a long inventory read is usually just slower. Pacing is not a guarantee: retries are bounded, so a wide enough read can still come back throttled or time out. Narrow the read, honour any retry delay the vendor sends, and check whether a write landed before repeating it — see Retrying a failed or timed-out write.

Rotating or replacing the credentials

Create a replacement under Settings → Integrations → API, update the saved key in Gorelo's StackJack details drawer, and choose Re-test. After the replacement works, use Revoke on the old key in the same Gorelo API settings. Revocation is immediate.

Disconnecting Gorelo

Choose Disconnect in the Gorelo details drawer and confirm. StackJack deletes its stored credential and stops making Gorelo calls. Disconnecting does not revoke the upstream API key; revoke it separately under Settings → Integrations → API. Connector subscription changes are separate from credential disconnection.

Troubleshooting

SymptomLikely causeWhat to do
The drawer shows Needs Attention after savingWrong region, a mis-pasted key, or the key lacks Clients (read)Re-check the region and generate a replacement key with Clients (read), then save and choose Re-test
One tool returns a 403 while others succeedThe key lacks the permission scope that operation needsGenerate a replacement key under Settings → Integrations → API with the required scope, update StackJack, and revoke the old key after validation
Tools worked, then started failingThe key was regenerated or revoked in GoreloPaste the current key in Connectors → Gorelo → Configure and save
A file your AI uploaded isn't on the ticketUploading stores the file and returns a link; it doesn't attach it on its ownAsk your AI to post a comment on the ticket carrying that file — the upload and the comment are two steps
A long comment comes back cut offComment lists return shortened bodiesAsk your AI to fetch that single comment; the single-comment read always returns the full text
A list seems to stop early, or repeats the same pageThe list was paged and the follow-up page wasn't requestedGorelo returns results a page at a time. Ask your AI to continue to the next page; it carries a cursor from the previous response
Write tools missing from your AI's tool listConnector is on the Free tier, or the tools aren't selected for your clientUpgrade the Gorelo connector plan and check your tool selections on the MCP Setup page
A calls-per-minute burst slows downStackJack is pacing requests towards Gorelo's limitExpected. Narrow the request if it does not finish.

Gorelo tools

gorelo_ · 118 tools · Free 60 · Pro 58

Contacts

ToolWhat it does
gorelo_create_contact
Pro · Write
Create a contact under a client, or a TEMPORARY contact with no client (the kind an email from an unknown requester creates; it can be the contact on a ticket that has no client).
gorelo_delete_contact
Pro · Destructive
Delete a contact (person) by its numeric id.
gorelo_get_contact
Free · Read-only
Get a single contact by its numeric id (from gorelo_list_contacts).
gorelo_list_contacts
Free · Read-only
List contacts (people) in the Gorelo CRM.
gorelo_update_contact
Pro · Write
Update an existing contact.

Clients

ToolWhat it does
gorelo_create_client
Pro · Write
Create a client (company).
gorelo_delete_client
Pro · Destructive
Delete a client (company) by its numeric id.
gorelo_get_client
Free · Read-only
Get a single client (company) by its numeric id (from gorelo_list_clients).
gorelo_list_client_locations
Free · Read-only
List the locations (sites) for one client.
gorelo_list_clients
Free · Read-only
List all clients (companies) in the Gorelo CRM.
gorelo_update_client
Pro · Write
Update an existing client (company).

Assets

ToolWhat it does
gorelo_create_custom_asset
Pro · Write
Create a custom (non-agent) asset — equipment Gorelo tracks without an RMM agent, such as a switch, printer or firewall.
gorelo_delete_agent_asset
Pro · Destructive
Delete an RMM agent device by its UUID id (from gorelo_list_agents).
gorelo_delete_custom_asset
Pro · Destructive
Delete a custom (non-agent) asset by its UUID id (from gorelo_list_custom_assets).
gorelo_get_agent
Free · Read-only
Get a single RMM agent device by its UUID id (from gorelo_list_agents).
gorelo_get_custom_asset
Free · Read-only
Get a single custom (non-agent) asset by its UUID id.
gorelo_list_agents
Free · Read-only
List all RMM agent devices.
gorelo_list_custom_asset_hardware_types
Free · Read-only
List the hardware types a custom asset can be given — your active custom asset types, which are exactly the hardwareTypeId values gorelo_create_custom_asset and gorelo_update_custom_asset accept.
gorelo_list_custom_assets
Free · Read-only
List custom (non-agent) assets — the equipment tracked in Gorelo without an RMM agent on it, such as switches, printers, firewalls and licences.
gorelo_update_custom_asset
Pro · Write
Update a custom asset.

Billing

ToolWhat it does
gorelo_delete_contract
Pro · Destructive
Delete a billing contract.
gorelo_get_contract
Free · Read-only
Get everything about one billing contract: the resolved client, the invoice schedule (daysBeforeInvoiceCreation, invoiceDue, autoApproveAndSend), contacts, and on each service line its labour-terms detail plus lineItems — the products and labour actually billed on that line.
gorelo_get_invoice_pdf
Free · Read-only
Download the rendered PDF for an invoice by its UUID id.
gorelo_list_billing_roles
Free · Read-only
List the billing roles configured for your organization.
gorelo_list_contracts
Free · Read-only
List billing contracts, each with its service lines inline.
gorelo_list_taxes
Free · Read-only
List the tax rates configured for your organization — the lookup for every tax id the API emits (a product category's taxId and a contract line item's tax id are the same identifier).
gorelo_list_work_types
Free · Read-only
List the work types configured for your organization.

Time Entries

ToolWhat it does
gorelo_create_time_entry
Pro · Write
Log time against a ticket or a project task.
gorelo_delete_time_entry
Pro · Destructive
Delete a time entry by its numeric id.
gorelo_get_time_entry
Free · Read-only
Get a single time entry by its numeric id (from gorelo_list_time_entries).
gorelo_list_time_entries
Free · Read-only
List logged time across every ticket and task.
gorelo_update_time_entry
Pro · Write
Partially update a time entry by its numeric id.

Alerts

ToolWhat it does
gorelo_create_alert
Pro · Write
Raise an alert for a client.
gorelo_list_alerts
Free · Read-only
List the alerts raised for your organization, newest first by default.

Tickets

ToolWhat it does
gorelo_create_ticket
Pro · Write
Create a PSA ticket.
gorelo_delete_ticket
Pro · Destructive
Delete a ticket by its UUID.
gorelo_get_ticket
Free · Read-only
Get a single ticket by its UUID (from gorelo_list_tickets, or the ticketId gorelo_create_ticket returns).
gorelo_list_ticket_statuses
Free · Read-only
List the configured ticket statuses (id, name, baseStatusId, color, sortOrder, description).
gorelo_list_ticket_tags
Free · Read-only
List the configured ticket tags (id, name, description, isAiTag).
gorelo_list_ticket_types
Free · Read-only
List the configured ticket types (id, name, description, isAiType).
gorelo_list_tickets
Free · Read-only
List tickets.
gorelo_update_ticket
Pro · Write
Partially update a ticket by its UUID.

Ticket Conversations

ToolWhat it does
gorelo_add_ticket_comment
Pro · Write
Add a comment to a ticket.
gorelo_create_ticket_approval
Pro · Write
Create an approval on a ticket.
gorelo_create_ticket_side_conversation
Pro · Write
Create a side conversation on a ticket - a thread aimed at someone outside the ticket's main correspondence, such as a vendor.
gorelo_delete_ticket_comment
Pro · Destructive
Delete a comment from a ticket.
gorelo_get_ticket_approval
Free · Read-only
Get a single approval on a ticket, with its approvers.
gorelo_get_ticket_comment
Free · Read-only
Get a single comment on a ticket.
gorelo_list_ticket_comments
Free · Read-only
List the comments on a ticket.
gorelo_list_ticket_conversations
Free · Read-only
List the conversations on a ticket.

Attachments

ToolWhat it does
gorelo_upload_attachment
Pro · Write
Upload a single file and get back its name and a TEMPORARY secure link, to attach to a ticket, project task, project or document.
gorelo_upload_ticket_attachment
Pro · Write
Upload a single file to a ticket.

Uptime

ToolWhat it does
gorelo_create_uptime_check
Pro · Write
Create an uptime check.
gorelo_delete_uptime_check
Pro · Destructive
Delete an uptime check by its UUID.
gorelo_get_uptime_check
Free · Read-only
Get a single uptime check by its UUID.
gorelo_list_uptime_checks
Free · Read-only
List uptime checks (ICMP, HTTP and TCP monitors), newest first.
gorelo_update_uptime_check
Pro · Write
Update an uptime check.

Organization

ToolWhat it does
gorelo_create_api_key
Pro · Write
Create a Gorelo API key.
gorelo_delete_api_key
Pro · Destructive
REVOKE a Gorelo API key.
gorelo_list_api_keys
Free · Read-only
List your organization's Gorelo API keys, newest first, revoked ones included (revokedAt is set on a revoked key), so the list is the record of what was issued.
gorelo_list_organization_groups
Free · Read-only
List the groups (teams) in your Gorelo organization.
gorelo_list_organization_users
Free · Read-only
List the users in your Gorelo organization (your MSP's technicians/staff, not client contacts).

Invoices & Payments

ToolWhat it does
gorelo_create_invoice
Pro · Write
Raise a manual invoice against a client, with line items.
gorelo_delete_invoice
Pro · Destructive
Delete or void an invoice, depending on its status — the app's own delete/void action.
gorelo_delete_payment
Pro · Destructive
Delete a payment that was recorded through the API (gorelo_record_payment).
gorelo_get_invoice
Free · Read-only
Get one invoice with its description, attachments, payments and line items.
gorelo_list_invoices
Free · Read-only
List your invoices, filtered and sorted.
gorelo_record_payment
Pro · Write
Record a payment received outside Gorelo against an APPROVED invoice.

Items

ToolWhat it does
gorelo_create_item
Pro · Write
Create a product or a bundle in the item catalog.
gorelo_delete_item
Pro · Destructive
Delete a catalog item.
gorelo_get_item
Free · Read-only
Get one catalog item — a product or a bundle.
gorelo_list_item_categories
Free · Read-only
List the categories products are organised under, each with its subcategories (one level of nesting).
gorelo_list_items
Free · Read-only
List your item catalog: products and bundles (type says which; a bundle is a product made of other products).
gorelo_update_item
Pro · Write
Partially update a catalog item.

Deletions

ToolWhat it does
gorelo_list_deletions
Free · Read-only
List records that have been deleted, so a copy kept in sync through this API can remove them.

Documents

ToolWhat it does
gorelo_add_document_related_items
Pro · Write
Relate a document to other records, up to 100 per call.
gorelo_create_document
Pro · Write
Create a document.
gorelo_delete_document_related_item
Pro · Destructive
Remove one related item from a document.
gorelo_duplicate_document
Pro · Write
Duplicate a document: the copy has the current body and attachments (files and images are copied, never shared), the same client and parent, and goes last among its siblings.
gorelo_get_document
Free · Read-only
Get a single document with the current version's body and its children (the documents nested directly under it).
gorelo_get_document_pdf
Free · Read-only
Download a document as a PDF, rendered from the current version at request time (the title as a heading, then the body).
gorelo_get_document_version
Free · Read-only
Get one version of a document, with its body and attachments.
gorelo_list_document_related_items
Free · Read-only
List the records a document is related to.
gorelo_list_document_versions
Free · Read-only
List a document's saved versions, newest first, the current one included (isCurrent).
gorelo_list_documents
Free · Read-only
List your documents (the Gorelo knowledge base).
gorelo_restore_document_version
Pro · Write
Make an earlier version of a document the current one.
gorelo_update_document
Pro · Write
Update a document.

Forms

ToolWhat it does
gorelo_create_form_submission_link
Pro · Write
Issue a link through which a form can be submitted without a login.
gorelo_list_form_responses
Free · Read-only
List a form's submitted responses, newest first.
gorelo_list_forms
Free · Read-only
List your forms, most recently updated first.

Projects

ToolWhat it does
gorelo_add_project_comment
Pro · Write
Post a comment on a project.
gorelo_create_project
Pro · Write
Create a project.
gorelo_create_project_section
Pro · Write
Add a section to a project.
gorelo_delete_project
Pro · Destructive
Delete a project AND EVERY TASK IN IT.
gorelo_delete_project_comment
Pro · Destructive
Delete a comment on a project.
gorelo_delete_project_section
Pro · Destructive
Delete a section AND EVERY TASK IN IT (leaving them would strand them on no board).
gorelo_get_project
Free · Read-only
Get a single project: every field the list returns plus its description, sharedWithContactIds and watcherIds.
gorelo_get_project_comment
Free · Read-only
Get one comment on a project.
gorelo_list_project_comments
Free · Read-only
List a project's comments, newest first.
gorelo_list_project_sections
Free · Read-only
List a project's sections (the board's columns); a task's sectionId comes from here.
gorelo_list_project_tags
Free · Read-only
List the project tags — exactly the tagIds gorelo_create_project and gorelo_update_project accept.
gorelo_list_project_types
Free · Read-only
List the project types — exactly the typeId values gorelo_create_project and gorelo_update_project accept.
gorelo_list_projects
Free · Read-only
List projects, newest activity first by default.
gorelo_update_project
Pro · Write
Update a project.
gorelo_update_project_section
Pro · Write
Update a section's title or colour.

Project Tasks

ToolWhat it does
gorelo_add_project_task_comment
Pro · Write
Post a comment on a task.
gorelo_create_project_task
Pro · Write
Create a task on a project's board.
gorelo_create_project_task_approval
Pro · Write
Ask contacts to approve something on a task.
gorelo_create_project_task_side_conversation
Pro · Write
Start a side conversation on a task — a thread with somebody outside the task's own contacts, such as a vendor.
gorelo_delete_project_task
Pro · Destructive
Delete a task.
gorelo_delete_project_task_comment
Pro · Destructive
Delete a comment on a task.
gorelo_get_project_task
Free · Read-only
Get one task in full: everything the task list returns plus linked assets, blocking relationships in both directions, the reason behind its status, and the time recorded against it.
gorelo_get_project_task_approval
Free · Read-only
Get one approval on a task, with its approvers.
gorelo_get_project_task_comment
Free · Read-only
Get one comment on a task, always with its whole body (an emailed-in body is read back here).
gorelo_list_project_task_comments
Free · Read-only
List a task's comments, newest first.
gorelo_list_project_task_conversations
Free · Read-only
List the conversations on a task.
gorelo_list_project_tasks
Free · Read-only
List a project's tasks, in the board's own order by default so the response matches the app.
gorelo_update_project_task
Pro · Write
Update a task.