Skip to main content

​
Authentication

All SendSculpt API endpoints require authentication using a secret API Key. You must include this key in the header of every HTTP request you make to the SendSculpt servers. When you use one of the official SDKs, the client simply handles this for you upon initialization.

​
Obtaining an API Key

You can create and manage your API keys directly from your Dashboard:

Manage API Keys

Generate a new API key in the SendSculpt Dashboard Settings.
Keep your API keys confidential. Do not share them in publicly accessible areas such GitHub, client-side code, or public forums.

​
Passing the API Key (Raw HTTP)

If you are not using one of the official SDKs, you authenticate to the SendSculpt Mailer API by providing your API key in the x-sendsculpt-key header. 
curl --request POST \
  --url https://api.sendsculpt.com/api/v1/send \
  --header 'Content-Type: application/json' \
  --header 'x-sendsculpt-key: your_secret_api_key_here' \
  --data '...payload...'

​
Environment Handling

SendSculpt automatically handles the environment (Live or Sandbox) based on the API Key you provide.
  • Live Keys: Trigger actual email dispatches and impact your billing quota.
  • Sandbox Keys: Mimic the Live environment but bypass final delivery, useful for local development and testing. You can view the emails in your dashboard under the Sandbox tab.