Connect a tool
Integrations connect HeyMoa to the tools your team already uses. Right now you can connect Linear (issue tracking) and GitHub (code hosting). Integrations belong to a workspace (the space your team shares), and you can have one per tool.
Only admins can connect and disconnect integrations. If you're not an admin, the buttons are hidden and a message says only admins can do this. If you need a new integration, ask an admin.
- Open the integration card Go to [Settings] → [Workspace] → [Integrations] and find the card for the tool (currently Linear and GitHub).
- Click [Connect] You're taken to the tool's sign-in page. Sign in and allow access, and you'll come back.
- Check the result Once connected, you'll see [Connected] with who connected it and when. If it fails, you'll see “The integration couldn't be connected. Please try again later.”
If another admin reconnects a tool, they become the person listed as having connected it. To disconnect, click [Disconnect].
What integrations let you do
My agent uses integrations to find and create issues.
- Linear: Look up teams and issues, and create and edit issues.
- GitHub: Search repositories and issues, and create issues.
==Creating and editing only happen after you click [Approve] on the approval card.== HeyMoa doesn't pull data from connected services on a schedule.
When an integration stops working
- Symptom
“The integration needs to be reauthorized.” appears
- Cause
The integration has to be authorized again before you can use it.
- Fix
An admin should connect that service again. The steps are the same as in Connect a tool above.
Frequently asked questions
Can I set up an integration if I'm not an admin?
No. Only admins can connect and disconnect integrations. Ask an admin.
Will issues be created without approval once a tool is connected?
No. Creating and editing only happen after you click [Approve] on the approval card.
Can I have more than one integration per service?
No. A workspace can have one integration per service.