Manifst Connectors

Connect Manifst to your software development tools to automatically synchronize tickets with your Git activity and receive real-time notifications in Slack and Discord.

Overview

Connectors are configured per project under Settings → Integrations. Only project owners can create or edit connectors.

Who gets access

A subscription grants capabilities to the account, never to the project. Being invited to a paying subscriber's project therefore grants no rights over their connectors: every member is assessed on their own plan.

Their work still feeds the connectors, though: their commits are linked to tickets, their edits are pushed to Jira, their actions fire notifications. The subscriber paid for a complete view of their project's delivery — a teammate's contribution is not removed from it, it simply stays invisible to that teammate.

GitHub

Configuration

1. In Manifst, open Settings → Integrations → GitHub → Configure.
2. Copy the displayed secret key (visible only once).
3. In GitHub, open your repository → Settings → Webhooks → Add webhook.
4. Payload URL: the URL displayed in Manifst after saving.
5. Content type: application/json required
6. Secret: the secret key copied in step 2.
7. Events: Pushes + Pull requests.
8. Click Add webhook. GitHub sends a ping event — Manifst responds {"ok":true}.

Push — Link a commit to a ticket

Include a #<PREFIX>-<id> reference in your commit message to automatically link the commit to the matching item.

#<PREFIX>-<numeric id>

The prefix is the one shown in front of the item in Manifst. Every ticket type defined in the project is recognised — not just US — along with both roadmap levels:

git commit -m "fix: login form validation #US-42"

git commit -m "feat: add pagination support #US-17 #US-18"

git commit -m "fix: crash on startup #BG-7"

Multiple references in a single commit are supported.

Branch name

The branch name is parsed too, without the hash sign: no commit-message discipline is needed when your naming convention already carries the reference.

git checkout -b feature/US-42-login-form
git checkout -b hotfix/BG-7

The branch then appears in the Development panel of the item, next to commits and pull requests.

Pull Requests

Mention one or more items in the PR title or description, using the same syntax as for commits. The PR's source branch is parsed as well: a PR coming from feature/US-42-… is linked even without an explicit mention.

GitHub's closing keywords (fix, fixes, close, closes, resolve, resolves…) placed in front of a reference are recognised and recorded as a closing intent.

## Changes
User profile form implementation.

Closes #US-15 #US-23

The link status in Manifst is updated automatically whenever the PR state changes:

Auto-close stories on merge

When a PR is merged, Manifst can automatically move linked tickets to a designated "Done" column.

To enable this feature:

1. In Settings → Integrations → GitHub, toggle on Automatically close stories on merge.
2. Select the destination column from the dropdown list (columns of type "done" in your Kanban board).
3. Save. Any merged PR referencing a ticket will move the referenced tickets to that column, whatever their prefix.

Once, at merge time

Closing fires on the event that performs the merge, not on the "merged" state. In practice, if you reopen a ticket by hand afterwards, later editing the PR title or description will not close it again. A human decision is never overwritten by a text change on GitHub.

An automatically closed ticket carries an "auto-closed" note under the matching link, in the Development panel of its page.

GitLab

Configuration

1. In Manifst, open Settings → Integrations → GitLab → Configure.
2. Copy the displayed token (visible only once).
3. In GitLab, open your project → Settings → Webhooks → Add new webhook.
4. URL: the one displayed in Manifst after saving.
5. Secret token: the token copied in step 2.
6. Trigger: Push events + Merge request events.
7. Leave Enable SSL verification ticked, then Add webhook.

References

The syntax is identical to GitHub: #<PREFIX>-<id> in a commit message, the branch name parsed without a hash sign, and closing keywords recognised. See the GitHub section for details — it is literally the same parsing code.

Private repositories and self-managed instances

The connector is inbound: GitLab calls Manifst. A private repository therefore works exactly like a public one — no repository access token is needed, and Manifst never reads your code.

A self-managed instance works too, on one condition: it must be able to reach Manifst's public URL. An instance behind a corporate firewall can often call out even when inbound access is impossible — what matters is the direction of travel.

One nuance about links: the ones recorded point at your repository. On a private repository, a Manifst member without GitLab access will land on a login page. That is the expected behaviour — repository permissions belong to GitLab.

Slack

Configuration

1. In Slack, create an Incoming Webhook at api.slack.com/apps → your app → Incoming Webhooks → Add New Webhook to Workspace. Select the target channel.
2. Copy the generated Webhook URL (format: https://hooks.slack.com/services/T…/B…/…).
3. In Manifst, open Settings → Integrations → Slack → Configure.
4. Paste the URL into the Webhook URL field.
5. Check the desired events.
6. Click Test Connection to verify message delivery, then click Save.

Available Events

Message Format

Messages use Slack mrkdwn formatting. Here are examples for each event:

🔄 *Status updated* — *Update user profile*
Backlog → In progress

👤 *Story assigned* — *Add pagination*
Assigned to *Marie Dupont*

💬 *New comment* on *Update user profile*
By *Jean Martin*: Form must handle profile avatar upload…

🚀 *Sprint started* — *Sprint 3 — Auth & Profile*

✅ *Sprint ended* — *Sprint 3 — Auth & Profile*

Discord

Configuration

1. In Discord, open your channel → Channel Settings → Integrations → Webhooks → New Webhook.
2. Name the webhook (e.g. Manifst), select the channel, then click Copy Webhook URL.
   The URL format is https://discord.com/api/webhooks/<id>/<token>.
3. In Manifst, open Settings → Integrations → Discord → Configure.
4. Paste the URL into the Webhook URL field.
5. Check the desired events.
6. Click Test to send a test message to Discord, then click Save.

Available Events

Events are identical to the Slack connector — a single event can trigger both Slack and Discord webhooks simultaneously if both are enabled.

Embed Format

Discord notifications utilize embeds with distinct sidebar colors per event type. Text supports standard Discord Markdown (**bold**, *italic*, `code`).

Sample Discord webhook JSON payload:

{
  "embeds": [{
    "description": "🔄 **Story updated** — **Update user profile**\nStatus: `Backlog` → `In progress`",
    "color": 5793266
  }]
}

Power BI / REST API

This connector requires no configuration in Manifst — it consists of consuming the v1 API directly from Power BI. Refer to the API Documentation for the full list of endpoints.

Key & Prerequisites

• An account on the Portfolio plan (REST API access included).
• An API key generated under Settings → API Keys with at least finance:read (EVM & portfolio indicators) and roadmap:read (dependencies & milestones). Add tickets:read, time:read, team:read as needed.
• The Base API URL: https://manifst.net/api/v1

Before configuring Power BI, test your key with a quick PowerShell command — if it returns JSON {"data":[…]}, you are ready:

curl.exe -H "Authorization: Bearer mfst_live_YOUR_KEY" https://manifst.net/api/v1/projects

Connecting Power BI Desktop

The API authenticates via an Authorization: Bearer header. The most reliable pattern is declaring it inside a Power Query M script using Web.Contents (compatible with scheduled cloud refresh). Open Home → Transform data → New Source → Blank Query → Advanced Editor and paste:

let
    BaseUrl = "https://manifst.net/api/v1",
    ApiKey  = "mfst_live_YOUR_KEY",
    Source  = Json.Document(
        Web.Contents(BaseUrl, [
            RelativePath = "finance",
            Query   = [ project = "PROJECT_UUID" ],
            Headers = [ Authorization = "Bearer " & ApiKey ]
        ])
    )
in
    Source[data]

When Power BI prompts for authentication credentials, select Anonymous: credentials are passed directly via the HTTP header. Obtain your project UUID from the /projects endpoint.

Portfolio Roll-up (Multi-Project)

The /portfolio/finance endpoint aggregates EVM data for all accessible projects in a single request — perfect for program management. It returns a consolidated totals object plus project-level details.

let
    BaseUrl = "https://manifst.net/api/v1",
    ApiKey  = "mfst_live_YOUR_KEY",
    Source  = Json.Document(
        Web.Contents(BaseUrl, [
            RelativePath = "portfolio/finance",
            Headers = [ Authorization = "Bearer " & ApiKey ]
        ])
    ),
    Projects = Table.FromRecords(Source[data][projects])
in
    Projects

The consolidated roll-up block is accessible via Source[data][totals] (Σ BAC, portfolio CPI/SPI, total VAC…). To filter for specific projects, add Query = [ projects = "uuid1,uuid2" ].

Incremental Refresh & Pagination

Large endpoints /tickets and /time-entries support pagination and date filtering passed in the query parameters:

            RelativePath = "tickets",
            Query = [ project = "PROJECT_UUID", updated_since = "2026-07-01", per_page = "500", page = "1" ],
            Headers = [ Authorization = "Bearer " & ApiKey ]

Troubleshooting

Security

GitHub — HMAC Verification

GitHub requests are signed with HMAC-SHA256 via the X-Hub-Signature-256 header. Invalid signatures are rejected with HTTP 401.

Slack — SSRF Protection

Only https://hooks.slack.com/services/… endpoints are accepted. Webhooks pointing to local or private IP spaces are rejected.

Discord — SSRF Protection

Only https://discord.com/api/webhooks/<id>/<token> URLs are accepted. Tokens must match [A-Za-z0-9_-] patterns.

Rate Limiting

The Test Connection button is rate-limited to 5 calls per minute per user per project.

Slack & Discord Circuit Breaker

If delivery fails 5 consecutive times, the connector is automatically disabled to prevent silent errors. Re-enable it once the webhook URL is fixed.

FAQ

GitHub webhook returns ignored: invalid_json

Set GitHub webhook Content type to application/json in GitHub repository Settings → Webhooks.

Webhook returns ignored: integration_not_configured

The GitHub integration has not been created or was deleted for this project. Set it up in Settings → Integrations.

Commits are linked (refs_linked: 1) but story status does not change

A push links commits for reference without altering story status. To close stories automatically, use a merged Pull Request with auto-close enabled.

I am not receiving Slack notifications

• Verify event checkboxes in connector settings.
• Use Test Connection to ensure the Webhook URL remains valid.
• Check if the connector was disabled by the circuit breaker.
• Verify that the Slack app remains installed in your workspace.

Can I connect multiple GitHub repositories?

A single GitHub connector per project is supported. For multi-repo setups, configure multiple GitHub webhooks targeting the same Manifst URL.

A teammate cannot see the "Development" panel

Connectors are included from the Team plan onwards, and the capability is assessed on their subscription — not the project owner's, and not the project itself. A member on the Starter plan therefore sees neither the panel nor the commit badges, even on a project whose connector works fine. Their own commits are still linked, and remain visible to members who are entitled to them.

Lost GitHub secret key

Secrets are shown only once upon creation. If lost, click Regenerate Secret in Manifst and update the value in GitHub.

Not receiving Discord notifications

• Verify event checkboxes in connector settings.
• Use Test to verify webhook status.
• Check for circuit breaker auto-disablement.

Can Slack and Discord connectors be active simultaneously?

Yes. Both connectors function independently and send notifications simultaneously if configured for the same event.

Is the Discord token visible to non-owner project members?

No. Webhook URLs are masked in the API for non-owners (only the first 4 token characters are visible). Only project owners see the full URL.