API token authentication

Access the Vend Email API directly with personal access tokens.

Creating a token

To use the API, you'll first need to generate a personal access token:

1. Go to your Personal access tokens page from your dashboard
2. Click "Add"
3. Enter a descriptive name for your token (e.g., "Development API")
4. Your new token will be displayed, starting with ve_token_ followed by 48 random characters

Using your token

Include your token in API requests using the Authorization header:

curl -H "Authorization: Bearer ve_token_abc123..." \
  https://www.vend.email/api/v1/me

Example response:

{
  "id": "123456",
  "email": "[email protected]"
}

Security best practices

• Keep your tokens secure and never share them publicly
• Use different tokens for different applications or environments
• Rotate tokens periodically for enhanced security
• Delete tokens that are no longer needed
• Never commit tokens to source control or include them in client-side code