Claron
    Documentation
    INTEGRATIONS
    Per-project
    Reviewed

    Integrations

    Claron connects to your existing tools — push annotations as tickets and receive notifications. Integrations are configured per-project from Dashboard → Integrations.

    Connect, configure, and test

    1. Open Dashboard → Integrations and select the Claron project

      You need permission to manage that project's integration.

    2. Choose an available provider and Connect

      Authorize an external account with access to the intended team/project/channel, or enter the provider credential/webhook requested by its form.

    3. Choose the destination and default status/field mapping, then save the configuration

      A successful authorization alone does not choose a ticket destination.

    4. Use Test to check the connection

      Then push a controlled annotation and inspect the resulting ticket or notification in the provider. A passing connection test alone does not prove delivery or sync.

    5. For any offered sync option, enable it deliberately and test one change in each required direction

      Verify comments and attachments separately; do not assume every provider mirrors every field.

    Provider-specific destinations

    Providers marked Coming soon, including the currently displayed Azure DevOps, Basecamp, Height, and Microsoft Teams entries, are not instructions to enable a released integration. Git repository access in Settings → Version Control is separate from an issue-tracker integration.

    ProviderAccess and configuration
    LinearAuthorize access to the intended team; select that team and default state. Test issue creation and the offered two-way status workflow.
    JiraAuthorize the Jira site/project with issue-creation permission; select project, issue type, and default status. Check required fields and priority mapping.
    TrelloAuthorize the intended board; select board and list. Test creation of a card in that exact list.
    AsanaGrant project access; select workspace, project, and default section. Check the created task's destination.
    ClickUpGrant access to the workspace; select workspace, space, list, and default status. Check priority/status on a test task.
    ShortcutSelect the team and workflow state; confirm the created story is in that workflow.
    NotionShare the intended database with the connection; select that database. Check the generated page and required properties.
    MondaySelect board, status column, and default status; verify the created item's column mapping.
    SlackAuthorize the workspace/channel, select the destination channel, and test a notification there.
    DiscordUse a channel webhook you are allowed to manage; keep its URL secret and test delivery.

    Connect Claron to Linear

    1. Authorize the intended workspace

      Choose Linear → Connect for the selected Claron project. Use a Linear account with access to the team that should receive reports.

    2. Choose the team and default state

      In the configuration panel, select team, then default state, and save. States belong to the selected team; select a new state if you change teams.

    3. Check the issue and status workflow

      Test the connection, push a sample annotation, and open its linked Linear issue. Confirm the team, title, and state. Test a supported status change back in Claron before relying on two-way updates.

    Connect Claron to Jira

    1. Authorize Jira access

      Choose Jira → Connect and authorize the intended Atlassian account. It needs access to the Jira project and permission to create its issues.

    2. Select the ticket destination

      Select project, issue type, and default status in that order, then save. Check that the displayed projects belong to the Jira site you intended to authorize.

    3. Check a created issue

      Test the connection, push a sample annotation, and open the Jira issue. Confirm project, issue type, priority, and description. If Jira rejects it, check required fields and the project's available priorities; successful sign-in alone does not satisfy those requirements.

    Connect Claron to Trello

    1. Authorize board access

      Choose Trello → Connect using an account that can add cards to the intended board.

    2. Choose board and list

      Select board, then list, and save. A list from a previous board is not the destination for the newly selected board.

    3. Verify the card

      Test the connection and push a sample annotation. Open the created card and check that it is in the chosen board and list, with the expected report link.

    Connect Claron to Asana

    1. Authorize project access

      Choose Asana → Connect with an account permitted to add tasks to the intended project.

    2. Choose the task destination

      Select workspace, project, and default section, then save. If a project is missing, check the authorized account's membership before reconnecting.

    3. Verify the task

      Test the connection, push a sample annotation, and inspect the Asana task's project, section, title, and report link.

    Connect Claron to ClickUp

    1. Authorize workspace access

      Choose ClickUp → Connect with access to the workspace and list that should receive reports.

    2. Choose the list and status

      Select workspace, space, list, and default status, then save. Recheck the downstream selections whenever you change their parent destination.

    3. Verify the task

      Test the connection and push a sample annotation. Inspect the ClickUp task's list, status, priority, and report link rather than treating authorization as proof of correct mapping.

    Connect Claron to Shortcut

    1. Provide the requested credential

      Choose Shortcut → Connect and use the credential requested by the form, from an account that can create stories in the intended workspace.

    2. Choose team and workflow state

      Select team and workflow state, then save. Check that the state is appropriate for the stories you are creating.

    3. Verify the story

      Test the connection, push a sample annotation, and inspect the story's team, workflow state, and report link. Resolve webhook-registration warnings before expecting incoming updates.

    Connect Claron to Notion

    1. Grant database access

      Choose Notion → Connect and authorize or provide the credential requested by the form. Share the intended database with that connection.

    2. Choose the database

      Select database and save. If it is missing, check its sharing permissions for the connection; your own ability to open it is not sufficient.

    3. Verify the page

      Test the connection and push a sample annotation. Inspect the new page in the selected database and its title, report link, and available properties.

    Connect Claron to Monday.com

    1. Authorize board access

      Choose Monday → Connect and provide the authorization or credential requested by the form. Use an account allowed to create items on the intended board.

    2. Choose board and status mapping

      Select board, status column, and default status, then save. The selected status must belong to that board's chosen column.

    3. Verify the item

      Test the connection and push a sample annotation. Check the created item's board, mapped status column, title, and report link.

    Send Claron notifications to Slack

    1. Authorize the workspace

      Choose Slack → Connect and approve access in the intended Slack workspace. Workspace app-installation rules can require an administrator's approval.

    2. Choose the channel

      Select channel in Claron's configuration panel and save. Ensure the connection can post there; do not assume a channel in another workspace is available.

    3. Verify a notification

      Test the connection, then trigger an enabled annotation event and inspect the message in that channel. Check project notification preferences if authentication succeeds but no event message arrives.

    Send Claron notifications to Discord

    1. Create a channel webhook

      In Discord, use a channel you are allowed to manage and create its webhook. Copy the webhook URL privately; anyone with that credential may be able to post to the channel.

    2. Connect the webhook

      Choose Discord → Connect for the intended Claron project and enter the webhook URL requested by the form. The webhook itself selects the channel; there is no separate channel picker.

    3. Verify delivery

      Test the connection, trigger an enabled annotation event, and inspect the message in Discord. If the webhook is deleted or rotated, update the saved connection and test again.

    Push, sync, and member scope

    Push creates or updates the provider-linked item through the permitted annotation action. Notification channels send messages; they are not issue trackers. Two-way status sync means a configured supported provider status change can be reflected back, not that all comments/attachments are universally synchronized.

    Owners, developers, and testers can be eligible for Full integration scope. Provider only and None limit the member's integration workflow; scope is separate from project visibility and the provider account's own permissions.

    Do not expose internal annotations/comments to an external audience by choosing a public board or channel. Check the destination's membership before pushing sensitive evidence.

    Reconnect and diagnose failures

    For authorization expired/reconnect required, reconnect the intended external account, then verify its project/channel and saved mappings. A reconnect can lose access if the account or repository grant changed.

    For missing targets, check provider membership, connection access, and selected parent resources. For rejected tickets, check required fields, issue type, statuses, and the mapped destination. For silent messages, check channel access and notification preferences.

    After correcting the configuration, send a controlled test and inspect the actual result. Repeatedly reconnecting without checking the target can create duplicate provider items.

    HOW IT LOOKS IN THE APP

    This example uses sample connections; its controls do not authorize external accounts. Each category has a header showing the connected count, followed by provider rows. Each row shows the provider logo, name, description, and action buttons (Connect when disconnected; Test + Disconnect when connected). Connected providers expand to show an inline config panel.

    Issue Trackers & BoardsSample connections
    Linear

    Linear

    Issues and cycles

    Connected
    Jira

    Jira

    Projects and boards

    Trello

    Trello

    Boards and cards

    Asana

    Asana

    Tasks and projects

    More providers below. Azure DevOps, Basecamp, and Height are marked Coming soon.
    Notification ChannelsSample connections
    Slack

    Slack

    Channel messages

    Discord

    Discord

    Server webhooks

    Microsoft Teams

    Microsoft Teams

    Channel notifications · Coming soon

    Coming soon

    ALL PROVIDERS

    Issue Trackers & Boards

    LinearLinearIssues and cycles
    JiraJiraProjects and boards
    TrelloTrelloBoards and cards
    AsanaAsanaTasks and projects
    ClickUpClickUpTasks and spaces
    ShortcutShortcutStories and epics
    NotionNotionDatabase pages
    Monday.comMonday.comBoard items
    Azure DevOpsAzure DevOpsSoonWork items
    BasecampBasecampSoonTo-dos and messages
    HeightHeightSoonTasks

    Notification Channels (3)

    SlackSlackChannel messages
    DiscordDiscordServer webhooks
    Microsoft TeamsMicrosoft TeamsChannel notifications · Coming soon

    PER-MEMBER INTEGRATION SCOPE

    Owners can control each team member's access level to every connected integration. This is set via the Manage integration access option in the member row's role dropdown.

    INLINE CONFIG PANEL

    After connecting a provider, click the ↓ chevron to expand the inline config panel. This is where you set the target project/board/workspace for ticket creation. Config is saved per-project.

    AUTH REFRESH & RECONNECT

    If a provider token expires while loading integration resources, Claron first attempts automatic token refresh (for OAuth providers that support refresh). If refresh fails or is unavailable, Claron returns a reconnect-required state and starts OAuth reconnect from the integrations panel.

    Step 1: Resource call returns auth-expired response.

    Step 2: Backend attempts refresh + automatic retry.

    Step 3: If still unauthorized, UI triggers reconnect flow.

    Step 4: Previous integration config values are preserved after reconnect.