Subscribers

Add a new subscriber (direct add)

Creates a subscriber entry immediately, without double opt-in. When the daily direct-add quota is exceeded, the request fails with a guidance message to use CSV import or the /subscribers/opt-in endpoint.

post/subscribers

Request

  • Base URL: https://api.maildroppa.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maildroppa.com/subscribers
  • Auth: API key in header X-API-Key

Request body

emailstring

Subscriber email address.

firstNamestring

Subscriber first name.

tagsstring[]

List of tag identifiers associated with the subscriber.

subscriberStatus'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED'
topicIdsstring[]

Active topic ids the subscriber joins. Missing means the tenant default topic.

Example request

{
  "fields": [
    {
      "value": {
        "text": "Ann"
      }
    }
  ]
}

Response

Subscriber created.

idstring uuid
tagsstring[]

List of tag identifiers associated with the subscriber.

subscriberStatus'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED'
registeredAtstring

Registration date/time of the subscriber.

lastImportedAtUtcstring date-time
gdprAgreementstring

Text of GDPR agreement if applicable.

Example response

{
  "lastImportedAtUtc": "2022-03-10T16:15:50Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.