Place a DFY Order

Places a DFY order: purchases the domains and creates ready-to-send email accounts on them, in a single order.

⚠️ Billing warning: this creates REAL recurring subscriptions charged to the organization's card on file. There is no dry-run mode. Only one order per organization can be submitted per 60 seconds.

Fields:

provider (required): GOOGLE_WORKSPACE or MS_ENTERPRISE

domains (required): the domains to order (max 100)

senders (required): the sender identities for the mailboxes - first_name, last_name, optional profile_picture_url, and (GOOGLE_WORKSPACE) optional prefixes (the part before the @). When prefixes is omitted, up to 3 are generated from the sender's name (e.g. john, john.doe, john.d). A maximum of 3 prefixes total per order.

total_accounts (required): explicit confirmation of how many email accounts the order creates. GOOGLE_WORKSPACE: domains × prefixes. MS_ENTERPRISE: domains × 99. If the number does not match, the order is rejected with the expected count and nothing is charged.

mailbox_password (GOOGLE_WORKSPACE only, required): password for the created mailboxes - 8-25 chars with an uppercase letter, a digit and a special character; must not contain a prefix.

usernames (MS_ENTERPRISE only, optional): exactly 99 username variations for the accounts; when omitted they are generated from the sender names.

master_inbox_email, forwarded_domain: optional.

MS_ENTERPRISE orders create 99 email accounts per domain.

Pre-checks (nothing is charged when they fail):

Domains already running on Google Workspace are rejected.

A mismatching total_accounts is rejected with the expected count.

Outcomes:

200 {"subscribed": true} - order placed. Track provisioning via GET /dfy/subscriptions.

200 {"subscribed": false, "message": ...} - payment succeeded but the domain purchase failed; the order is recorded and support is notified.

400 - validation error, pre-check failure, or the card on file could not be charged (complete the payment from the app in that case).

application/json

Order placed. subscribed: false means payment succeeded but the domain purchase failed (order recorded, support notified).

Bodyapplication/json

curl --location 'https://api.plusvibe.ai/api/v1/dfy/place-order' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "workspace_id": "65099a0dd96fae8ab61130c0", "provider": "GOOGLE_WORKSPACE", "domains": [ "acme-growth.com", "acme-reach.com" ], "senders": [ { "first_name": "John", "last_name": "Doe" } ], "total_accounts": 6, "mailbox_password": "Str0ng!Pass1" }'

Request

Responses