API Overview

Overview

The Nashra API gives you programmatic access to manage your newsletter subscribers and custom fields. Use it to build custom integrations, automate subscriber management, or connect Nashra to your existing tools.

Base URL

All API requests are made to:

https://app.nashra.ai/api

What you can do

The API provides access to these resources:

Subscribers

Manage the people on your subscriber list:

• List all subscribers with pagination and search
• Create new subscribers
• Update subscriber details, tags, and custom field values
• Delete subscribers

Tags

Organize your subscribers:

• List all tags
• Create, update, and delete tags

Custom fields

Extend your subscriber data with custom fields:

• List all custom fields
• Create new fields (text, number, date, boolean)
• Update and delete fields

Segments

View subscriber segments:

• List all segments
• Get segment details with subscriber counts

Authentication

All API requests must include your API token as a Bearer token in the Authorization header. See the Authentication page for details on creating and using API tokens.

Response format

All responses are returned as JSON. Successful responses include the requested data in a data field, with additional information in a meta field. Error responses include an error field with a description of what went wrong.

Getting an API token

You can create API tokens from your Nashra dashboard:

1. Go to Settings > API Tokens
2. Click Create Token
3. Copy the token — it is only shown once

See the Authentication page for full details.

Rate limits

The API is rate-limited to 60 requests per minute per token. See the Rate Limits page for details on headers and handling limits.