Request a higher start
Ask Notix to let a domain start above the automatic 2,000 emails a day, as the "Request a higher start" button on the domain page and the switch-over…
https://app.usenotix.dev/api/v1/domains/{id}/start-requestNeeds a full access key. Sending access keys cannot call this. Key permissions lists the extra rules some calls have.
Ask Notix to let a domain start above the automatic 2,000 emails a day, as the "Request a higher start" button on the domain page and the switch-over screen does. Give requestedCap, the emails a day to start at: above 2,000 and at most 100,000. It only asks: a Notix admin looks at the domain's age at your old provider, the daily volume and bounce rate we sampled there, and its DNS here, then approves the amount, approves a different amount, or declines. The answer is the new state (as GET answers).
The domain needs recent history from your old provider for this exact domain (migrate it with the Migration Center first), must be sending (not paused or on hold), and can have one request waiting at a time: a second answers 409. An amount of 2,000 or less, or above 100,000, answers 400.
Who can call it
Full access keys made by someone who is a team admin today (or the team owner), as the button is for team admins: a key made by a member answers 403, and so does a key made before Notix recorded who made each key. A key limited to one domain may ask about that domain only; any other id answers 404. Read only, send-only and live AI keys answer 403 SCOPE_DENIED. Notix's own domains answer 403. Every request is recorded in the key's audit log.
The team can call this 10 times a minute; past that the answer is 429 with Retry-After. When Notix cannot count the calls the answer is 503 SERVICE_UNAVAILABLE, never a 429.
Path parameters
Minimum 0. Maximum 2147483647.
Body parameters
Emails a day to start at. Above 2,000 and at most 100,000.
Minimum 2001. Maximum 100000.
Headers
Bearer followed by your API key.
Errors
An amount of 2,000 or less, or above 100,000; no recent history from your old provider for this exact domain; or the domain is paused or on hold.
`SCOPE_DENIED`: a read only, send-only or live AI key. Or a key made by a team member who is not an admin today, or a domain that belongs to Notix.
No domain with this id for the calling team, or a key limited to one domain asked about another.
A request for this domain is already waiting for Notix.
The team asked for 10 higher starts in the last minute.
Notix cannot count the team's calls just now; try again shortly.
Every error has the same shape. See all error codes.
curl -X POST "https://app.usenotix.dev/api/v1/domains/<id>/start-request" \
-H "Authorization: Bearer $NOTIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"requestedCap": 5000
}'
{
"domainId": 1,
"canRequest": true,
"automaticStart": 1,
"maxRequest": 1,
"request": {
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"status": "PENDING",
"requestedCap": 1,
"approvedCap": 1,
"createdAt": "2026-10-01T09:00:00Z",
"decidedAt": "2026-10-01T09:00:00Z"
}
}