For Agents
Manage email contacts and lists, add or remove subscribers, manage verified sender identities, and pull campaign reports for the Get a Newsletter platform. Supports upsert via PUT for predictable sync workflows.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Get a Newsletter API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Get a Newsletter API.
Upsert customer contacts into Get a Newsletter using email as the natural key
Maintain mailing lists and add or remove subscribers in response to product or CRM events
Register and verify sender email identities before launching a campaign
Retrieve campaign reports to feed open and click rates back into analytics dashboards
GET STARTED
Use for: Add a new subscriber to my newsletter list, Upsert a contact by email into Get a Newsletter, Remove a subscriber from a mailing list, List all mailing lists in my Get a Newsletter account
Not supported: Does not handle transactional email, SMS, or push notifications — use for newsletter campaign list management and reporting only.
Jentic publishes the only available OpenAPI specification for Get a Newsletter API, keeping it validated and agent-ready. Get a Newsletter is a Nordic email marketing platform used to build and send newsletters, manage subscribers, and report on campaign performance. The API exposes contacts, mailing lists, list subscribers, sender identities, and campaign reports across 25 endpoints, supporting upsert via PUT for both contacts and lists. It is most often used to sync customers from a CRM or e-commerce system into segmented mailing lists and to pull campaign reports back for analytics.
Segment subscribers by list membership for targeted campaign sends
Unsubscribe a contact from a specific list when a customer opts out
Patterns agents use Get a Newsletter API for, with concrete tasks.
★ CRM-to-List Synchronisation
Marketing teams want a customer's CRM segment to drive their newsletter membership automatically — for example, putting all paying customers on a 'customers' list and all trial users on a 'trials' list. The Get a Newsletter API supports upsert by email on contacts and add-to-list on subscribers, so a recurring sync job can keep the list aligned with the CRM segment without duplicates.
For each contact in the CRM 'customers' segment, call `PUT /contacts/{email}/` to upsert and `POST /lists/{hash}/subscribers/` to add to the customer list.
Transactional Subscribe Flow
When a user signs up to a marketing list on a website, the front-end captures the email and the backend needs to create the contact and add them to a chosen list. The API's contact creation and subscriber addition endpoints support this flow with predictable responses, and the upsert pattern via PUT means re-submissions don't create duplicates.
On form submission, call `PUT /contacts/{email}/` then `POST /lists/{hash}/subscribers/` to subscribe the user to the chosen list.
Campaign Report Pipeline
Analytics teams want campaign open rate, click rate, and bounce data alongside web analytics in a single warehouse. The API's reports endpoints expose campaign-level metrics so a daily job can pull report records and load them into a destination such as BigQuery or Snowflake for combined dashboards.
Call `GET /reports/` for new reports since yesterday and `GET /reports/{id}/` for each report ID, then load the records into a warehouse table.
Agent-Driven Newsletter Subscription
An AI agent assisting a customer can subscribe them to the right list when they ask 'sign me up for product updates'. Through Jentic, the agent discovers the subscriber-add endpoint, executes it with the customer's email, and replies with confirmation — without ever holding the API key.
Resolve the customer's email and the requested list slug, then call `POST /lists/{hash}/subscribers/` via Jentic and confirm the success response to the customer.
25 endpoints — jentic publishes the only available openapi specification for get a newsletter api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/contacts/{email}/
Upsert a contact by email
/lists/{hash}/subscribers/
Add a subscriber to a mailing list
/lists/{hash}/subscribers/{email}/
Remove a subscriber from a list
/lists/
List all mailing lists
/reports/{id}/
Get a specific campaign report
/senders/{id}/request_confirmation/
Request sender email confirmation
/contacts/{email}/
Upsert a contact by email
/lists/{hash}/subscribers/
Add a subscriber to a mailing list
/lists/{hash}/subscribers/{email}/
Remove a subscriber from a list
/lists/
List all mailing lists
/reports/{id}/
Get a specific campaign report
Three things that make agents converge on Jentic-routed access.
Credential isolation
Get a Newsletter API tokens are stored encrypted in the Jentic vault. Agents call newsletter operations via Jentic and the platform injects the `Authorization` header — the raw token never enters the agent's prompt.
Intent-based discovery
Agents search Jentic by intent (e.g. 'add a subscriber to a mailing list' or 'pull a campaign report') and Jentic returns the matching Get a Newsletter operation with its input schema.
Time to first call
Direct integration: 1-2 days to model contacts, lists, sender confirmation, and report polling. Through Jentic: under an hour for the first call, reusable across agents and downstream automations.
Alternatives and complements available in the Jentic catalogue.
Specific to using Get a Newsletter API through Jentic.
Why is there no official OpenAPI spec for Get a Newsletter API?
Get a Newsletter does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Get a Newsletter API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Get a Newsletter API use?
The API uses an API token in the `Authorization` header (`tokenAuth` scheme). Through Jentic, the token is stored encrypted in the vault and injected at execution time, so agents never see the raw value.
Can I upsert a contact by email with the Get a Newsletter API?
Yes. Use `PUT /contacts/{email}/` to update or create a contact in a single call, which is the safe pattern for idempotent CRM sync.
Can I add a subscriber to a specific mailing list?
Yes. Call `POST /lists/{hash}/subscribers/` with the email to add a contact to the list identified by `{hash}`. Use `DELETE /lists/{hash}/subscribers/{email}/` to remove.
How do I retrieve a campaign report through Jentic?
Search Jentic for `get a newsletter campaign report`, load the schema for `GET /reports/{id}/`, and execute with the report ID. Jentic injects the API token from the vault.
Does the Get a Newsletter API send transactional emails?
No. The API focuses on newsletter campaigns and list management. For transactional email (password resets, receipts), use a dedicated transactional service alongside Get a Newsletter.
/senders/{id}/request_confirmation/
Request sender email confirmation