Approve GEO Content Brief
Irreversibly approve a draft or failed brief and queue the paid Notra writer. This claims the brief and books writer work.
ActionTry it
Integrate Notra
with your AI CRM
Create and manage content, AI agents, feedback workflows, and generative engine optimization data with Notra.
Explore Triggers and Actions
Cancel Post Schedule
Destructively cancel every post destination that has not started and clear failed destinations. A destination already publishing cannot be interrupted; it finishes and is not retried, and in_progress reports this case.
ActionTry it
Create Agent Session
Starts a durable paid AI agent session with an initial user message and returns its session ID. Read subsequent output from the session event stream. This can consume credits and produce unbounded streamed model output; do not retry blindly after an ambiguous failure.
ActionTry it
Create Chat
Create a paid Notra chat, persist the first message, and wait for the full assistant stream. The response is newline-delimited stream text rather than parsed message parts and may run for an unbounded model/tool duration. Limited with chat messages to 30 requests per minute per organization; retrying creates another chat and may repeat tool side effects.
ActionTry it
Create Event Trigger
Creates a persistent GitHub event automation that generates the selected content type for matching releases or pushes and can publish the result automatically. This is a paid operation.
ActionTry it
Create GEO Project
Create a persistent GEO project linked to a brand identity. Requires an active paid plan or positive AI credit balance and a GEO plan.
ActionTry it
Create GEO Prompt
Persist a custom prompt for future GEO scans. Requires paid access and an active GEO plan.
ActionTry it
Create GEO Scan
Irreversibly queue a paid GEO scan that records checks against configured answer engines. The scan record is created before hand-off; poll the returned status URL. Requires sufficient plan or AI credits, rejects concurrent scans with 409, and is limited to 4 requests per hour per organization.
ActionTry it
Create GEO Sequence
Persist a one-to-five-turn GEO prompt sequence for tracked runs. Requires paid GEO access.
ActionTry it
Create GitHub Integration
Connect a GitHub repository to Notra, enabling changelog generation and creating a webhook secret. This paid operation stores a supplied personal access token for private repositories; never pass a token unless required. Limited to 20 requests per minute per API key.
ActionTry it
Create Post
Create a draft or published Notra post directly from supplied content without invoking AI generation.
ActionTry it
Create Schedule
Creates a recurring schedule that generates one content type from the selected GitHub integrations. Times are in UTC. A schedule with the same source, targets, output, and lookback settings as an existing one is rejected with 409. This paid operation creates a persistent recurring automation that may generate and auto-publish content on future runs; review enabled and auto_publish before calling.
ActionTry it
Create Skill
Creates a custom skill. Names must be unique within the organization. This paid operation creates a persistent agent skill.
ActionTry it
Create Webhook
Create a paid outbound webhook subscription that causes persistent external deliveries. The signing secret is returned only once and must be stored securely.
ActionTry it
Delete Brand Identity
Permanently delete a non-default brand identity and disable every schedule or event trigger that references it. The default identity cannot be deleted.
ActionTry it
Delete Event Trigger
Delete an event trigger. Permanently delete an event trigger and stop future matching events from running it.
ActionTry it
Delete GEO Competitor
Permanently stop tracking a competitor and return the remaining competitor list.
ActionTry it
Delete GEO Project
Permanently delete a GEO project and cascade-delete its settings, prompts, sequences, competitors, scans, checks, and reports, while cancelling pending scans. Feedback is detached, not deleted. The last project or a project with hosted Sites cannot be deleted.
ActionTry it
Delete GEO Prompt
Permanently stop tracking a GEO prompt. This destructive change removes it from future scans and requires an active GEO plan.
ActionTry it
Delete GEO Sequence
Permanently delete a tracked GEO prompt sequence so it can no longer be run.
ActionTry it
Delete Integration
Permanently delete a Notra GitHub or Linear integration and disable every schedule or event trigger that targets it.
ActionTry it
Delete Post
Permanently delete one Notra post by ID. Use only when the post is no longer needed; this operation cannot be undone.
ActionTry it
Delete Schedule
Deletes the schedule and stops future runs. Posts generated by earlier runs are kept. Permanently delete a schedule and stop future runs; posts from previous runs remain.
ActionTry it
Delete Skill
Deletes a custom skill. System skills cannot be deleted. Permanently delete an agent skill.
ActionTry it
Delete Webhook
Permanently remove a Notra webhook subscription and cancel all deliveries that have not yet been sent.
ActionTry it
Generate Brand Identity
Create a brand identity immediately and queue a paid, irreversible website-analysis job that fills its company, tone, and audience fields. Poll NOTRA_GET_BRAND_IDENTITY_GENERATION; limited to 5 requests per minute per API key.
ActionTry it
Generate Post
Queue a paid, irreversible AI post-generation job. The call consumes plan capacity or credits even if later generation fails. Poll NOTRA_GET_POST_GENERATION until terminal; limited to 10 requests per minute per API key.
ActionTry it
Get Brand Identity
Get one Notra brand identity by ID. A missing identity is represented by a successful response with brand_identity set to null.
ActionTry it
Get Brand Identity Generation
Get a brand identity analysis job. Poll until status is completed or failed, then fetch job.brand_identity_id with NOTRA_GET_BRAND_IDENTITY.
ActionTry it
Get Chat
Get one Notra chat and its complete message history by chat ID.
ActionTry it
Get Chat By External Channel
Find the Notra chat linked to a Discord or Slack channel ID.
ActionTry it
Get Event Trigger
Returns one GitHub event trigger with its event filters, monitored repositories, generated content type, and publishing settings.
ActionTry it
Get Feedback
Returns one feedback entry with its classification, triage status, submission context, and timestamps.
ActionTry it
Get GEO Agent Readiness
Get the latest stored agent-readiness report, any newer run state, score history, and comparison for a GEO project's website without starting a scan.
ActionTry it
Get GEO Competitor Share
Read paid-plan competitor share-of-voice metrics without starting a scan.
ActionTry it
Get GEO Competitor Visibility
Read one competitor's paid-plan mention history without starting a scan.
ActionTry it
Get GEO Content Brief
Read one stored paid-plan GEO content brief without approving or starting writer work.
ActionTry it
Get GEO Ingest Setup
Read paid-plan traffic installation snippets and endpoints. This does not issue or rotate credentials, but deploying the returned setup changes external traffic collection.
ActionTry it
Get GEO Language Share
Read paid-plan GEO visibility by language without starting a scan.
ActionTry it
Get GEO Project
Get one GEO project. All GEO endpoints require an active GEO plan.
ActionTry it
Get GEO Prompt History
Read stored paid-plan checks for a tracked prompt without starting a scan.
ActionTry it
Get GEO Prompt Result Detail
Read one stored paid-plan prompt result without starting a scan.
ActionTry it
Get GEO Prompt Results
Read stored paid-plan prompt answers and grounding data without starting or billing a scan.
ActionTry it
Get GEO Scan
Get one GEO scan's status, progress and mentions by engine, including safe failure metadata. Legacy scans may have null planned totals. Requires an active GEO plan.
ActionTry it
Get GEO Sentiment
Read current and previous paid-plan GEO sentiment metrics without starting billed analysis.
ActionTry it
Get GEO Sentiment Analysis
Read cached paid-plan thematic sentiment analysis. This never starts or bills a model run.
ActionTry it
Get GEO Settings
Get the complete GEO configuration and current scan state for a project. Requires an active GEO plan.
ActionTry it
Get GEO Traffic Journey
Read the paid-plan events in one AI traffic journey without changing tracking setup.
ActionTry it
Get GEO Traffic Log
Read a bounded set of recent paid-plan AI traffic events without changing tracking setup.
ActionTry it
Get GEO Traffic Overview
Get AI crawler, citation, referral, and conversion traffic totals, source breakdowns, and daily points for a GEO project.
ActionTry it
Get GEO Visibility Overview
Get mention rates, checks, citations, visibility, and average positions by answer engine for a GEO project and date window.
ActionTry it
Get GEO Visibility Timeseries
Read paid-plan daily GEO visibility metrics. This does not start a scan or bill an analysis job.
ActionTry it
Get Post
Get one Notra post by ID, including its rendered content, markdown source, metadata, and publication status. A missing post is returned as post=null.
ActionTry it
Get Post Generation
Get a post generation job and event log. Poll until status is completed, failed, or skipped; when completed, fetch job.post_id with NOTRA_GET_POST.
ActionTry it
Get Post Schedule
Get a post's current publishing schedule and the state of every destination, or null when no schedule exists.
ActionTry it
Get Public API Status
Check whether Notra's public API is reachable and discover its authentication metadata without a connected credential.
ActionTry it
Get Skill
Returns a skill by name, including its full instructions and whether it is built into Notra.
ActionTry it
Get Webhook Delivery
Get one Notra webhook delivery, including its serialized payload and complete attempt history.
ActionTry it
Get Workspace Context
Return the workspace and authentication context bound to the connected Notra credential, optionally including pending workspace invitations.
ActionTry it
Import GEO Competitors
Bulk create or update a project's persistent competitor list from up to 2,000 rows or CSV. Existing names are updated rather than duplicated; send the whole list in one request. Paid GEO operation limited to 10 requests per 10 minutes per organization.
ActionTry it
Import GEO Prompts
Bulk-persist up to 500 tracked prompts from rows or CSV. Existing prompts are skipped rather than duplicated. Requires paid GEO access and is limited to 10 requests per 10 minutes per organization.
ActionTry it
Issue Geo Ingest Token
Returns the current tracking token together with the install snippets. Pass `projectId` for a project-specific token; without it, the legacy token only accepts the organization's oldest project's hosts. Issuing does not invalidate previously issued tokens; use rotation for that. Issue a sensitive GEO ingest bearer token. Store the returned token securely and never log or expose it.
ActionTry it
List Agent Sessions
Returns recent agent sessions and their linked chat IDs, origin surfaces, statuses, and timestamps. Results can contain sensitive conversation metadata.
ActionTry it
List Brand Identities
List the workspace's brand identities, with the default first, for selecting brand context in content and GEO workflows.
ActionTry it
List Chats
List the workspace's Notra chat sessions without loading message histories.
ActionTry it
List Event Triggers
Returns the organization's GitHub event triggers, optionally filtered to triggers monitoring any of the supplied repository IDs.
ActionTry it
List Feedback
List workspace feedback with optional triage-status, kind, and project filters.
ActionTry it
List GEO Changes
Compare the two latest stored paid-plan GEO scans without starting a new scan.
ActionTry it
List GEO Competitors
List competitors tracked for a GEO project. Requires an active GEO plan.
ActionTry it
List GEO Content Briefs
List stored paid-plan GEO briefs. This read does not plan, approve, or bill work.
ActionTry it
List GEO Content Gaps
Read paid-plan content opportunities and linked briefs. This does not plan, approve, or bill content work.
ActionTry it
List GEO Projects
List the connected workspace's paid GEO projects and their brand associations.
ActionTry it
List GEO Prompt Result Summaries
Return one bounded page of stored paid-plan prompt result summaries; no scan is started.
ActionTry it
List GEO Prompts
List custom and automatically derived prompts tracked for a GEO project. Requires an active GEO plan.
ActionTry it
List GEO Scans
List paginated GEO scans with planned, completed, mentioned, and failed check totals by engine plus safe failure metadata. Requires an active GEO plan.
ActionTry it
List GEO Sentiment Evidence
Return one bounded page of stored paid-plan sentiment evidence without starting analysis.
ActionTry it
List GEO Sequences
List tracked multi-turn GEO prompt sequences. Requires an active GEO plan.
ActionTry it
List GEO Shelf Sources
Return one bounded page of paid-plan cited and tracked GEO sources without starting a scan.
ActionTry it
List GEO Traffic Journeys
List a bounded set of paid-plan AI traffic journeys without changing tracking setup.
ActionTry it
List GEO Traffic Pages
List a bounded paid-plan ranking of pages visited by AI traffic without changing tracking setup.
ActionTry it
List Integrations
List enabled GitHub and Linear integrations and their IDs for use as Notra content-generation sources. The Slack list is always empty.
ActionTry it
List Post Authors
List Notra post authors and their IDs for assigning authors to blog posts and changelogs.
ActionTry it
List Posts
List the connected workspace's posts, with filters for publication status, content type, and brand identity. Notra returns published posts only unless statuses includes both draft and published.
ActionTry it
List Schedules
Returns the organization's cron schedules, newest first. repositoryMap maps each targeted GitHub integration ID to an owner/repo label.
ActionTry it
List Skills
Returns the organization's skills sorted by name, including built-in system skills (isSystem: true). Skill content is omitted; use GET /v1/skills/{name} to read it.
ActionTry it
List Webhook Deliveries
List Notra webhook delivery history at a specific offset, optionally filtered by delivery status. Increase offset to continue when has_more is true.
ActionTry it
List Webhooks
List Notra outbound webhook subscriptions without exposing their signing secrets.
ActionTry it
Plan GEO Content Brief
Plan and save a GEO content brief. This paid operation books AI credits; autoApprove also starts the billed writer. A 409 after four minutes may still finish, so do not retry; list briefs instead.
ActionTry it
Post Chat Message
Persist a message or tool-approval decisions in an existing paid Notra chat and wait for the full assistant stream. Earlier history is included automatically. The response is newline-delimited stream text and may run for an unbounded model/tool duration. Tool approvals can trigger external mutations; retrying can duplicate them. Limited with chat creation to 30 requests per minute per organization.
ActionTry it
Replace GEO Settings
Replace the project's GEO settings and re-arm its recurring scan. Unknown engines or languages are rejected; hidden engine selections are retained, the prompt language remains tracked, and ZDR is disabled without its add-on. This persistent scheduling change requires paid access and a GEO plan.
ActionTry it
Retry Webhook Delivery
Queue a paid redelivery of a failed webhook while retaining its prior attempt history. This sends the payload to the external endpoint again and can duplicate downstream effects.
ActionTry it
Rotate Geo Ingest Token
Invalidates every tracking token previously issued for this organization and returns a fresh one. Deployments still sending the old token stop being accepted immediately. Irreversibly rotate the sensitive GEO ingest bearer token, immediately invalidating the previous token. Store the replacement securely and never log or expose it.
ActionTry it
Run GEO Sequence
Irreversibly execute every turn of a tracked sequence against every available answer engine and record checks, consuming paid Notra model capacity. The synchronous call may take minutes and is limited to 10 runs per 10 minutes per organization. A 409 after four minutes means work continues; do not retry and instead read project GEO checks.
ActionTry it
Schedule Post
Schedule a paid future publication that marks the saved post published in Notra and can create and merge a GitHub pull request or post to X or LinkedIn. Replaces any schedule that has not started; later post edits are included. Publishing occurs within about one minute and transient failures retry automatically.
ActionTry it
Send Agent Session Message
Sends the next turn of an agent session. The server binds the session's stored continuation token, so the client-provided one is ignored. Answer input.requested events (tool approvals, questions) from the event stream via inputResponses. Send a paid message to an AI agent session. This can consume credits and produce unbounded streamed model output; do not retry blindly after an ambiguous failure.
ActionTry it
Start GEO Agent Readiness Scan
Queue a paid readiness scan of the project's linked website. This starts external scanning work; an identical in-flight scan may be reused.
ActionTry it
Stream Agent Session Events
Fetch and parse the durable NDJSON event response for an agent session after Notra closes the response, including input.requested events for tool approvals. This call does not deliver events incrementally and returned events can contain sensitive conversation content.
ActionTry it
Submit Feedback
Record feedback for the organization that owns the credential. Requires an API key with the feedback.write scope. Agents and MCP servers should post to the organization's feedback URL instead. Submit persistent workspace feedback. This paid write has no delete endpoint.
ActionTry it
Submit Organization Feedback
Record feedback from an AI agent or integration by posting to the organization's feedback URL, as shown on the Feedback page in the dashboard. No credentials are required. Limited per source IP and per organization. Submit persistent feedback without authentication. This paid write has no delete endpoint and is rate-limited by source IP and organization.
ActionTry it
Suggest GEO Competitors
Use Notra's paid discovery operation to suggest competitors for a domain. Results are cached per organization and domain; requests are limited to 10 per 10 minutes per organization.
ActionTry it
Update Brand Identity
Update selected fields of a Notra brand identity. This paid mutation can also change the organization's default identity by setting is_default to true.
ActionTry it
Update Event Trigger
Replaces an existing GitHub event trigger's filters, monitored repositories, generated content type, and publishing settings. This paid operation changes future automation behavior.
ActionTry it
Update Feedback
Changes a feedback entry's triage status and returns the updated entry. This is a paid write operation.
ActionTry it
Update GEO Project
Rename a GEO project or relink its brand identity. This changes persistent project configuration and requires paid access and a GEO plan.
ActionTry it
Update GEO Prompt
Enable or disable a tracked prompt, or replace labels on a custom prompt. This changes future scan coverage and requires paid GEO access.
ActionTry it
Update GEO Sequence
Change a tracked sequence's name, turns, or enabled state. This affects future paid GEO runs.
ActionTry it
Update Post
Update selected fields of an existing Notra post. Markdown changes re-render content; when title is omitted, Notra derives it from the first markdown heading or keeps the existing title if there is no heading. Status changes can publish or unpublish the post, and content or metadata changes may sync a linked GitHub pull request.
ActionTry it
Update Schedule
Replaces the schedule. Send the full schedule body; fields that are omitted are not preserved from the existing schedule. This paid operation replaces the schedule configuration and can change future generation or automatic publishing behavior.
ActionTry it
Update Skill
Updates the name, description, or content of a skill. System skills can be edited but not renamed. This paid operation changes an existing agent skill.
ActionTry it
Upsert GEO Competitor
Create, update, or rename a persistent tracked competitor, matching names case-insensitively, and return the full list. Requires paid GEO access.
ActionTry it
How the Notra integration works
The Notra integration connects your Dench AI CRM directly to Notra, so agents can read and act on your Notra data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
110 actions are available for agents to invoke on your behalf. Every call runs through Notra's own authorization, scoped to the account you connect.
Set up Notra in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Notra and click Connect — you'll authorize access through Notra's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Notra in chat, or call it from an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Notra integration work with Dench?
The Dench Notra integration connects your AI CRM to Notra, so AI agents can work with your Notra data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Notra via Dench?
The Notra integration currently exposes 110 actions, including Approve GEO Content Brief, Cancel Post Schedule, Create Agent Session, Create Chat, Create Event Trigger, and Create GEO Project. Agents invoke them on your behalf from chat or from automations.
Do I need to write code to connect Notra to Dench?
No. You connect Notra from your Dench workspace using Notra's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Notra integration secure?
Connections are authorized through Notra's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Notra connection from your workspace settings at any time.