Unisender

MARKETING · MARKETING

Contact lists, contacts, and email and SMS campaigns in the account they connected.

Connecting Unisender in practice

Unisender’s headline allowance is 1,200 requests per 60 seconds, but the methods an agent actually needs are metered separately and far tighter: sendEmail and getContactCount are 60 per 60 seconds and exportContacts is 20. Budgeting against the 1,200 figure will overrun the send path by twenty times.

Rate limits

General limit: 1,200 requests per 60 seconds.
sendEmail: 60 requests per 60 seconds. getContactCount: 60 per 60 seconds.
exportContacts: 20 requests per 60 seconds.
createCampaign: 100 per 60 seconds. subscribe: 300 per 60 seconds. checkEmail: 300 per 60 seconds. sendSms: 300 per 60 seconds.

Worth knowing

Limits are per method, not per account, so a contact import and a campaign send draw on separate buckets and a single client-side limiter will be wrong for both.
exportContacts at 20 a minute makes a full contact export the slowest operation in the API by an order of magnitude, so reconciliation jobs need to be incremental.
createCampaign at 100 a minute is the real cap on any per-segment campaign automation, well under the general limit.
The per-method limit table is published in the Russian-language reference; the English /en/support/api/ pages now return 410 Gone, so the authoritative numbers are at unisender.com/ru/support/api/common/api-limits/.

Checked against Unisender API request limits (2026-09-29), Unisender API method index (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

unisender_async_export_contactsREAD

Export contacts (async) via POST /{lang}/api/async/exportContacts. Start a contact export and return a task_uuid; poll async/getTaskResult for the download link. Filters narrow the export to one list, contact or status. Rate limit 20 requests/60s per API key or IP.

api

unisender_async_get_campaign_delivery_statsREAD

Get per-address delivery report (async) via POST /{lang}/api/async/getCampaignDeliveryStats. Start a per-address delivery report for one campaign and return a task_uuid; poll async/getTaskResult for the download link.

api

unisender_async_get_task_resultREAD

Get async task result via POST /{lang}/api/async/getTaskResult. Status of an asynchronous task, and its download link once finished. Universal: it serves async/exportContacts and async/getCampaignDeliveryStats alike, and names which method the task belongs to.

api

unisender_cancel_campaignWRITE

Cancel campaign via POST /{lang}/api/cancelCampaign. Cancel a scheduled campaign that has not been sent yet.

api

unisender_check_emailREAD

Check email delivery status via POST /{lang}/api/checkEmail. Delivery status of one or more messages sent by sendEmail. Rate limit 300 requests/60s per API key or IP.

api

unisender_check_smsREAD

Check SMS delivery status via POST /{lang}/api/checkSms. Delivery status of a message sent by sendSms.

api

unisender_create_campaignWRITE

Create campaign via POST /{lang}/api/createCampaign. Schedule or start a campaign for a message created earlier. SENDS REAL MAIL: with no start_time the send begins immediately. Rate limit 100 requests/60s per API key or IP.

api

unisender_create_email_messageWRITE

Create email message via POST /{lang}/api/createEmailMessage. Create an email message for a later campaign and return its message id. File attachments are not offered: Unisender takes them as raw binary content and forbids base64, which no JSON argument can carry.

api

unisender_create_email_templateWRITE

Create email template via POST /{lang}/api/createEmailTemplate. Create a reusable email template and return its id.

api

unisender_create_fieldWRITE

Create contact field via POST /{lang}/api/createField. Create an additional contact field and return its id.

api

unisender_create_listWRITE

Create contact list via POST /{lang}/api/createList. Create a new contact list and return its id.

api

unisender_create_sms_messageWRITE

Create SMS message via POST /{lang}/api/createSmsMessage. Create an SMS message for a later campaign and return its message id.

api

unisender_create_subscriber_noteWRITE

Create contact note via POST /{lang}/api/createSubscriberNote. Attach a note to a contact.

api

unisender_delete_fieldWRITE

Delete contact field via POST /{lang}/api/deleteField. Delete an additional contact field and every value stored in it.

api

unisender_delete_listWRITE

Delete contact list via POST /{lang}/api/deleteList. Delete a contact list. The contacts themselves stay in the account.

api

unisender_delete_messageWRITE

Delete message via POST /{lang}/api/deleteMessage. Delete a message created by createEmailMessage or createSmsMessage.

api

unisender_delete_subscriber_noteWRITE

Delete contact note via POST /{lang}/api/deleteSubscriberNote. Delete a contact note.

api

unisender_delete_tagWRITE

Delete tag via POST /{lang}/api/deleteTag. Delete a tag and remove it from every contact carrying it.

api

unisender_delete_templateWRITE

Delete template via POST /{lang}/api/deleteTemplate. Delete an email template.

api

unisender_excludeWRITE

Exclude a contact via POST /{lang}/api/exclude. Exclude a contact from the named lists, or from every list when none are named.

api

unisender_get_actual_message_versionREAD

Get current message version via POST /{lang}/api/getActualMessageVersion. Id of the current version of a message that has been edited.

api

unisender_get_campaign_common_statsREAD

Get campaign summary statistics via POST /{lang}/api/getCampaignCommonStats. Aggregate delivery, open, click and unsubscribe counts for one campaign.

api

unisender_get_campaign_statusREAD

Get campaign status via POST /{lang}/api/getCampaignStatus. Current status of one campaign.

api

unisender_get_campaignsREAD

Get campaigns via POST /{lang}/api/getCampaigns. List campaigns started within a time window.

api

unisender_get_contactREAD

Get a contact via POST /{lang}/api/getContact. Read one contact by email address, optionally with its lists, fields and details.

api

unisender_get_contact_countREAD

Count contacts in a list via POST /{lang}/api/getContactCount. Count the contacts in one list that match a search. At least one search parameter is required. Rate limit 60 requests/60s per API key or IP.

api

unisender_get_contact_field_valuesREAD

Get a contact's field values via POST /{lang}/api/getContactFieldValues. Read the values one contact holds in the named additional fields.

api

unisender_get_fieldsREAD

Get contact fields via POST /{lang}/api/getFields. List the account's additional contact fields with their ids, names and types.

api

unisender_get_listsREAD

Get contact lists via POST /{lang}/api/getLists. List every contact list in the account, with each list's id and title.

api

unisender_get_messageREAD

Get message via POST /{lang}/api/getMessage. Read one message by id, as returned by createEmailMessage or createSmsMessage.

api

unisender_get_messagesREAD

Get messages via POST /{lang}/api/getMessages. List messages created within a time window, with their bodies.

api

unisender_get_sender_domain_listREAD

Get sender domains via POST /{lang}/api/getSenderDomainList. Sender domains registered on the account, with their DKIM and verification state.

api

unisender_get_subscriber_noteREAD

Get contact note via GET /{lang}/api/getSubscriberNote. Read one contact note. GET only: this method answers 405 to a POST.

api

unisender_get_subscriber_notesREAD

Get a contact's notes via GET /{lang}/api/getSubscriberNotes. List one contact's notes, paged and sorted. GET only: this method answers 405 to a POST.

api

unisender_get_tagsREAD

Get tags via POST /{lang}/api/getTags. List every tag in the account with its id.

api

unisender_get_templateREAD

Get template via POST /{lang}/api/getTemplate. Read one template, user or system, with its body.

api

unisender_get_templatesREAD

Get templates via POST /{lang}/api/getTemplates. List templates with their bodies, filtered by type and creation window.

api

unisender_get_total_contacts_countREAD

Count all contacts via POST /{lang}/api/getTotalContactsCount. Total number of contacts in the account. Returns {"total": n}.

api

unisender_get_visited_linksREAD

Get link clicks via POST /{lang}/api/getVisitedLinks. Link clicks recorded for one campaign.

api

unisender_get_web_versionREAD

Get campaign web version via POST /{lang}/api/getWebVersion. The public web-page version of a sent campaign.

api

unisender_import_contactsWRITE

Import contacts via POST /{lang}/api/importContacts. Bulk add or update contacts: field_names names the columns and data carries one row per contact in that order. A column named 'delete' holding 1 DELETES that contact.

api

unisender_is_contact_in_listsREAD

Check list membership via POST /{lang}/api/isContactInLists. Whether a contact is in the given lists, under an 'or' or 'and' condition.

api

unisender_list_messagesREAD

List messages via POST /{lang}/api/listMessages. List messages created within a time window, without their bodies.

api

unisender_list_templatesREAD

List templates via POST /{lang}/api/listTemplates. List templates without their bodies, filtered by type and creation window.

api

unisender_send_emailWRITE

Send a single email via POST /{lang}/api/sendEmail. Send one transactional email immediately and return its email_id. SENDS REAL MAIL. User substitution fields are barely supported here, by design. File attachments are not offered: Unisender takes them as raw binary content and forbids base64, which no JSON argument can carry. Rate limit 60 requests/60s per API key or IP.

api

unisender_send_smsWRITE

Send an SMS via POST /{lang}/api/sendSms. Send one SMS immediately and return its sms_id. SENDS A REAL MESSAGE. Rate limit 300 requests/60s per API key or IP.

api

unisender_send_test_emailWRITE

Send a test email via POST /{lang}/api/sendTestEmail. Send a test copy of an existing message. SENDS REAL MAIL to the addresses given.

api

unisender_subscribeWRITE

Subscribe a contact via POST /{lang}/api/subscribe. Add one contact to one or more lists, setting its fields and tags. By default a confirmation email is sent; double_optin=3 adds the contact outright. Returns person_id. Rate limit 300 requests/60s per API key or IP.

api

unisender_unsubscribeWRITE

Unsubscribe a contact via POST /{lang}/api/unsubscribe. Mark a contact unsubscribed from the named lists, or from every list it is in when none are named. The contact's account-level status is unchanged.

api

unisender_update_email_messageWRITE

Update email message via POST /{lang}/api/updateEmailMessage. Edit an email message created earlier by createEmailMessage.

api

unisender_update_email_templateWRITE

Update email template via POST /{lang}/api/updateEmailTemplate. Edit an existing email template.

api

unisender_update_fieldWRITE

Update contact field via POST /{lang}/api/updateField. Rename an additional contact field.

api

unisender_update_listWRITE

Update contact list via POST /{lang}/api/updateList. Change a contact list's title or its before/after subscribe redirects.

api

unisender_update_opt_in_emailWRITE

Update opt-in confirmation email via POST /{lang}/api/updateOptInEmail. Replace the subscription-confirmation email sent for one list. The body MUST contain at least one link carrying the confirmation href.

api

unisender_update_subscriber_noteWRITE

Update contact note via POST /{lang}/api/updateSubscriberNote. Replace the text of an existing contact note.

api