# General API resources

Here you’ll be able to find all the information about the endpoints’ authorizations, possible statuses of your emails, and validation errors.

# Authentication

Authentication is done by adding an Authorization header to your API request that contains an API token.

In order to use the API token, it needs to be added as Authorization header with the contents of the header being Bearer XXX where XXX is your API token.

Authorization: Bearer XXX

API tokens are generated for sending domains and can have different permissions to limit which areas of your account they may be used to access. Read more

# Possible statuses

You can query the status of a sent email using the GET request with the ID of the email sent.

# Activity status list

Status Description
processed Our servers have processed your request and your email has been passed to our sending servers.
queued Your API request has been authorized and will be processed.
sent Your email was sent from our sending servers. We are now waiting for a response from the receiving servers.
delivered Your email was successfully delivered with no errors.
soft_bounced Your email was not delivered because it soft bounced. A soft bounce is a temporary rejection by a receiving recipient’s server. This may happen because the recipient's inbox is full.
hard_bounced Your message was not delivered. The message was returned to our servers because the recipient's address is invalid. A hard bounce may occur because the domain name does not exist or because the recipient is unknown. You will not be able to send future email messages to recipients that hard bounced. Use the Suppressions tool to check and manage all rejected recipients.
junk Your message was sent to your recipient’s junk file.
opened The recipient received your message and opened it. Opens tracking is only available if you enabled it in your domain settings.
clicked The recipient clicked a link that’s in your message. Likewise, clicks tracking is only available if you enabled it in your domain settings.
unsubscribed Your message was rejected because the recipient's email address is in your Suppression list.
spam_complaints Similarly, your message was rejected because the recipient's email address is in your Suppression list.

# Validation errors

You might experience some of the errors described below when authorization fails.

Response Code: 422 Unprocessable Entity
Response Headers:
	Content-Type: application/json
{
  "message": "The given data was invalid.",
  "errors": {
    "from.email": [
      "The from.email must be verified."
    ]
  }
}
Last updated: 6/15/2021, 7:14:57 AM