Inboxbooster API

Use api.inboxbooster.com endpoint.

API

Login

POST https://api.inboxbooster.com/api/v2/token/

{
    "email": "...",
    "password": "..."  
}

->

RESULT

OK HTTP 200

{
    "access": "...",
    "refresh": "..."
}

Refresh JWT Token

POST https://api.inboxbooster.com/api/v2/token/refresh/

{
    "refresh": "..."
}

->

OK HTTP 200

{
    "access": "..."
}

Check ISP of email

GET https://api.inboxbooster.com/api/v2/mx-lookup/{email-address}/

needs to be authenticated. Use Bearer with the token.

->

RESULT

OK HTTP 200

{
    "isp": "..."
}

Possible values: "gmail","outlook","yahoo","barracuda","cisco","mimecast","proofpoint","others","error"

request new test

POST https://api.inboxbooster.com/api/v2/prepare-test/

needs to be authenticated. Use Bearer with the token. Example with curl:

curl -v \
    -H "Content-Type: application/json" \
    -d '{"result_callback":"https://example.com/"}' \
    -H "Authorization: Bearer the.access.token" \
    https://api.inboxbooster.com/api/v2/prepare-test/

{
    "result_callback": "..."|null, // optional
}

result callback: url where Inboxbooster backend should post the result of an inboxplacement test.

->

RESULT

OK HTTP 200

{
    send_to: ["email1@example.com", "email2@example.com"],
    test_uuid: '...',
    test_url: "https://app.inboxbooster.com/…"
}

NOK HTTP 4xx

{
    message: "..."
}

OVERLOAD HTTP 500

{
    message: "..."
}

result callback

This is the optional callback sent by inboxbooster when a test is completed. The Inboxbooster side simply posts a json to this endpoint.

INFO:root:POST request,
Path: /
Headers:
Host: 4fe0-85-3-199-79.ngrok-free.app
User-Agent: python-requests/2.28.1
Content-Length: 574
Accept: */*
Accept-Encoding: gzip, deflate
Content-Type: application/json
X-Forwarded-For: 2600:1900:0:2d08::900
X-Forwarded-Host: 4fe0-85-3-199-79.ngrok-free.app
X-Forwarded-Proto: https

Body:
{"test_uuid": "92990e19-12c6-4a57-acae-764a269ad382", "status": "Done", "any_ip_block": false, "any_domain_block": false, "result_url": "https://dashboard.inboxbooster.com/spamfix/96990e19-12c6-4a57-acae-764a269ad382/", "email_subject": "test after callback_url fix", "email_from": "Test User <test@example.com>", "esp_results": [{"esp": "gmail", "test_status": "Solved", "dns_problem": "Yes", "reputation_problem": "No", "content_problem": "No"}, {"esp": "outlook", "test_status": "Solved", "dns_problem": "Yes", "reputation_problem": "No", "content_problem": "No"}]}

{
    "test_uuid": "96990e19-12c6-4a57-acae-764a269ad382", 
    "status": "Done",  // Done|Error
    "any_ip_block": false, 
    "any_domain_block": false, 
    "result_url": "https://dashboard.inboxbooster.com/spamfix/92990e19-12c6-4a57-acae-764a269ad382/",
    "email_subject": "test after callback_url fix", 
    "email_from": "Test User <test@example.com>", 
    "esp_results": [
        {
            "esp": "gmail", 
            "test_status": "Solved",  // Solved|Error
            "result": "Inbox",  // Inbox|Spam|Promotion|Not Applicable
            "dns_problem": "Yes", 
            "reputation_problem": "No", 
            "content_problem": "No"
        }, 
        {
            "esp": "outlook", 
            "test_status": "Solved", 
            "result": "Spam",
            "dns_problem": "Yes", 
            "reputation_problem": "No", 
            "content_problem": "No"
        }
    ]
}