Engagespot API

Name: Engagespot API
Brand: Engagespot API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsPush NotificationsapiKey8 EndpointsREST

For Agents

Send multi-channel notifications (in-app, email, SMS, push, Slack), manage notification recipients, and read or update user notification preferences for product workflows.

Install Jentic One Beta

Connect the Engagespot API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Engagespot 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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# 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 instance

Jentic 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.

Capabilities

What an agent can do with Engagespot API.

Trigger a notification workflow that fans out to in-app, email, SMS, push, and Slack channels

Create or upsert a recipient user record with channel identifiers like email and phone

Cancel an in-flight workflow run before it dispatches to recipients

GET STARTED

Start building with Engagespot API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Engagespot API, keeping it validated and agent-ready. Engagespot is a multi-channel notification infrastructure that lets product teams send in-app, email, SMS, push, web push, and Slack notifications from a single API. Workflows handle channel routing, batching, digesting, and per-user preferences so engineers do not have to build delivery logic per channel. The 8-endpoint REST API covers triggering notifications, managing recipient users, reading and updating user preferences, and cancelling in-flight workflow runs.

Use Cases

Patterns agents use Engagespot API for, with concrete tasks.

★ Multi-Channel Transactional Notifications

Trigger a single workflow that delivers the same event (password reset, order confirmation, payment receipt) across in-app inbox, email, SMS, push, and Slack without writing channel-specific delivery code. Engagespot routes per recipient based on channel availability and user preferences. Typical setup is under a day once a workflow template is defined in the Engagespot dashboard.

POST /notifications with workflow identifier 'order-shipped' and recipient userId 'cust_4821' to fan out a shipment notification across email and in-app channels

User Preference Management

Expose a notification preferences UI in your product where users opt in or out of categories per channel. The Engagespot API reads and updates these preferences so the workflow engine respects user choice automatically on every send. Reduces unsubscribe rates and meets compliance requirements for marketing communications.

GET /preferences for userId 'usr_9920' to fetch the user's category-by-channel preference matrix and present it for editing

User Lifecycle Sync

Keep Engagespot's recipient directory in sync with your application's user records. Create users on signup with their email, phone, and timezone, and delete them on account closure to honour data deletion requests. The /users endpoint supports both create and delete in the same workflow.

POST /users to register a new recipient with userId 'cust_4821', email and phone, then later DELETE /users when the customer closes their account

AI Agent Notification Dispatch via Jentic

An AI agent that monitors a process (build pipeline, fraud signal, support ticket SLA) can call the Engagespot API through Jentic to alert the right humans across the channels they prefer. Jentic resolves credentials and provides the workflow trigger schema so the agent only needs the workflow name and recipient ID.

Search Jentic for 'send a multi-channel notification', load the Engagespot workflow trigger schema, and POST /notifications with workflow 'incident-alert' and recipientId 'oncall-eng' when a monitored signal fires

Key Endpoints

8 endpoints — jentic publishes the only available openapi specification for engagespot api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/notifications

Trigger a workflow run for one or more recipients

GET

/notifications

List notifications sent to a user

POST

/notifications/delete-all

Bulk delete notifications from a user inbox

POST

/users

Create or upsert a recipient user

DELETE

/users

Delete a recipient user

PATCH

/workflows/{workflowId}/cancel

Cancel an in-flight workflow run

GET

/preferences

Read a user's notification preferences

POST

/notifications

Trigger a workflow run for one or more recipients

GET

/notifications

List notifications sent to a user

POST

/notifications/delete-all

Bulk delete notifications from a user inbox

POST

/users

Create or upsert a recipient user

DELETE

/users

Delete a recipient user

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Engagespot requires two paired secrets (X-ENGAGESPOT-API-KEY and X-ENGAGESPOT-API-SECRET). Jentic stores both in the encrypted vault (MAXsystem) and injects them at call time, so agents never see the raw keys.

Intent-based discovery

Agents search Jentic by intent like 'send a multi-channel notification' and Jentic returns the Engagespot POST /notifications operation with its input schema, so the agent calls the right endpoint without browsing docs.

Time to first call

Direct Engagespot integration: 1-2 days for auth, workflow setup, and recipient sync logic. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Engagespot API through Jentic.

Why is there no official OpenAPI spec for Engagespot API?

Engagespot does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Engagespot 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 Engagespot API use?

Engagespot uses two API key headers, X-ENGAGESPOT-API-KEY and X-ENGAGESPOT-API-SECRET, sent on every request. When you call Engagespot through Jentic, both keys are stored in the Jentic vault and injected at execution time so they never enter the agent's context.

Can I send a notification across multiple channels with one API call?

Yes. POST /notifications triggers a workflow you have defined in the Engagespot dashboard, and the workflow itself decides which channels (in-app, email, SMS, push, Slack) fire for each recipient based on their preferences. You only pass the workflow identifier and recipient details.

Can I cancel a notification after triggering it?

Yes, for workflow runs that are still in flight (for example digesting or scheduled). Call PATCH /workflows/{workflowId}/cancel with the workflowId returned from the trigger call. Notifications already dispatched to channels cannot be recalled.

How do I send a multi-channel notification through Jentic?

Run pip install jentic, then search for 'send a multi-channel notification', load the Engagespot POST /notifications operation schema, and execute with workflow identifier and recipient. Jentic returns the response without you handling the X-ENGAGESPOT-API-KEY headers directly.

What is the difference between users and preferences in this API?

Users are recipient records (id, email, phone, timezone) created via POST /users. Preferences are the per-user, per-channel, per-category opt-in matrix read via GET /preferences. You manage recipient identity in /users and recipient consent in /preferences.

Engagespot API

Connect the Engagespot API to your agent

Capabilities

Start building with Engagespot API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs