In this guide, we will show you how to send your first email with Cakemail Next-gen.
The first step is to obtain a token. Tokens are required to make subsequent API calls. To obtain your token, you simply have to call the Create a token endpoint along with your Cakemail username and password.
curl --request POST \
--url https://api.cakemail.dev/token \
--data-urlencode grant_type=password \
--data-urlencode username=[Cakemail username] \
--data-urlencode password=[Cakemail password]
import requests
token = requests.post(
url='https://api.cakemail.dev/token',
data={
'grant_type': 'password',
'username': '<Cakemail username>',
'password': '<Cakemail password>'
}
).json()
<?php
$ch = curl_init();
$payload = http_build_query([
'grant_type' => 'password',
'username' => '<Cakemail username>',
'password' => '<Cakemail password>'
]);
curl_setopt($ch, CURLOPT_URL, 'https://api.cakemail.dev/token');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$token = json_decode(curl_exec($ch));
This call, if successful, will return you a valid token containing:
- Access Token
- Token Type
- Expires In
- Refresh Token
The Access Token is what you will need to make the next API call. Before you can send your first email, you will need to create and confirm your first Sender. This step is required so we can make sure you have access to the mailbox of that sender.
To create your first sender, you will call the Add a sender endpoint along with a name and an email address.
curl --request POST \
--url https://api.cakemail.dev/brands/default/senders \
--header 'accept: application/json' \
--header 'authorization: Bearer [access token]' \
--header 'content-type: application/json' \
--data '{"name":"[name]","email":"[email address]"}'
import requests
sender = requests.post(
url='https://api.cakemail.dev/brands/default/senders',
headers={
'authorization': 'Bearer ' + token.get('access_token')
},
json={
'name': '<name>',
'email': '<email address>'
}
).json()
<?php
$ch = curl_init();
$payload = json_encode([
'name' => '<name>',
'email' => '<email address>'
]);
curl_setopt($ch, CURLOPT_URL, 'https://api.cakemail.dev/brands/default/senders');
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $token->access_token,
'Content-Type: application/json',
'Content-Length: ' . strlen($payload)
]);
$sender = json_decode(curl_exec($ch));
This will return you a sender object that has an ID. It will also send an email to the email address you specified in the previous step. The email you will receive will contain a Confirmation ID. You can then call the Confirm a sender endpoint along with the sender ID and the confirmation ID to confirm your first sender.
curl --request POST \
--url https://api.cakemail.dev/brands/default/senders/[sender ID]/confirm-email \
--header 'accept: application/json' \
--header 'authorization: Bearer [access token]' \
--header 'content-type: application/json' \
--data '{"confirmation_id":"[confirmation ID]"}'
import requests
confirmation = requests.post(
url='https://api.cakemail.dev/brands/default/senders' \
+ sender_id + '/confirm-email,
headers={
'authorization': 'Bearer ' + token.get('access_token')
},
json={
'confirmation_id': '<confirmation_id>'
}
).json()
This last step is actually optional. Clicking the link included in the email will also confirm the sender.
You are now ready to send your first email! To do so, you will call the Send a transactional email endpoint. This call requires at the minimum the following information:
- Recipient Email Address
- Sender ID
- Subject Line
- Email Body
curl --request POST \
--url https://api.cakemail.dev/emails \
--header 'accept: application/json' \
--header 'authorization: Bearer [access token]' \
--header 'content-type: application/json' \
--data '{"sender":{"id":"[sender ID]"},"content":{"encoding":"utf-8","subject":"[subject line]","text":"[email body]"},"email":"[recipient email address]"}'
import requests
confirmation = requests.post(
url='https://api.cakemail.dev/emails',
headers={
'authorization': 'Bearer ' + token.get('access_token')
},
json={
"sender": { "id": "[sender ID]" },
"content": {
"encoding": "utf-8",
"subject": "[subject line]",
"text": "[email body]"
},
"email": "[recipient email address]"
}
).json()
Wow! You just sent your first email with Cakemail!
Updated 13 days ago
What's Next
| Managing your contacts |