Check an e-mail sender's DNS now

POST/v1/email_senders/{id}/checkTry it

Checks the sender's DNS records now, instead of waiting for the next automatic check (every 15 minutes, and every minute while the sender is being set up), and returns the sender as it now stands, with every record and whether it was seen. At most once per 30 seconds per sender and 30 times an hour per organisation, else 429 too_many_checks. A failed sender whose records are right again starts over, with fresh DKIM records. 409 email_sender_removed for a removed sender. Needs brand_profiles read.

Path parameters

idstringrequired

Returns

200 application/json. The sender as it now stands. See the EmailSender object.

Errors have one shape; see Errors for every code.

Code language

Request

curl -X POST "https://api.parasend.com/v1/email_senders/{id}/check" \
  -H "Authorization: Bearer $PARASEND_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

const res = await fetch('https://api.parasend.com/v1/email_senders/{id}/check', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
});
const data = await res.json();

import os, requests, uuid

res = requests.post(
    "https://api.parasend.com/v1/email_senders/{id}/check",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.parasend.com/v1/email_senders/{id}/check");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/email_senders/{id}/check"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .header("Idempotency-Key", UUID.randomUUID().toString())
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.parasend.com/v1/email_senders/{id}/check', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

application/json