Resetup mailboxes

Schedule a renewal-resetup for selected Google Workspace mailboxes.

Each selected mailbox must be:

on the GOOGLE platform,

in scheduled_for_cancellation status, and

at least 11 months old (creation date older than 11 months from today).

The endpoint creates one resetup job per domain and validates each domain's admin credentials before saving the job. If a credential check fails, that domain is skipped with a generic validation message and contact support so we can fix it.

The renewal does not start immediately. It begins 5 days before the admin mailbox's renewal_date (or right away if the renewal is already within 5 days). Use /v1/api/mailboxes/resetup-status to track progress. Each resetup runs on the domain's next renewal cycle and has up to 24 hours of downtime for that domain while it runs — mail delivery is paused for that window.

Partial-success semantics: domains are validated independently. If some domains pass and others fail, you'll get a 200 with both kinds of entries in results. A 400 is returned only when no domain made it through.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

application/json

Resetup queued. Returned when at least one domain in the batch passed validation. Per-domain skip reasons (if any) appear inline in results.

Bodyapplication/json

curl --location 'https://api.inboxkit.com/v1/api/mailboxes/resetup' \ --header 'X-Workspace-Id;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "mailbox_uids": [ "string" ], "domain_uid": "string" }'

{ "error": false, "message": "Resetup scheduled", "results": [ { "error": true, "domain_uid": "string", "domain_name": "string", "resetup_uid": "string", "mailbox_uids_to_reprovision": [ "string" ], "mailbox_uids_to_backup": [ "string" ], "scheduled_run_at": "2019-08-24T14:15:22.123Z", "deferred": true, "message": "string" } ] }

Resetup mailboxes

Request

Responses