Apply a bulk import of managed accounts
Apply a bulk import of managed accounts and own tax IDs from files (multipart/form-data); returns 201.
- Declarative and NOT atomic: each row is applied on its own; failures come back as BLOCKED or ERROR.
- Idempotency-Key required; vouchers are returned EXACTLY ONCE, or emailed with options.send_email.
- Requires the privileged accounts:write scope.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/accounts/imports
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Headers
Client-generated opaque key (up to 255 characters; UUID v7 recommended) that makes retries safe: the first response is cached and replayed for repeats without re-executing the mutation. Reusing a key with a different body returns 422 idempotency_key_reused; the values of secret fields (password, secret…) count as part of the body, so retrying with a corrected secret under the same key is a different request, never the replay of the earlier answer. See the Idempotency guide. Required on this operation: repeating it delivers an effect that cannot be taken back (an email sent, a file generated, a third-party call, a charge), so a request without this header is rejected with 422 idempotency_key_required before any business logic runs.
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Response
Example response
{
"data": {
"id": "0199a1f0-1c22-7a10-b111-8a8b8c8d8e8f",
"object": "managed_account_import",
"status": "completed",
"stats": {
"total_rows": 2,
"valid": 2,
"created": 2,
"customers_queued": 3,
"monthly_amount_cents": 5000,
"proration_amount_cents": 2500,
"tax_amount_cents": 525,
"total_amount_cents": 3025
},
"rows": [
{
"line": 2,
"mode": "managed_account",
"external_ref": "cliente-0042",
"tax_id": "B12345674",
"status": "VALID",
"errors": {},
"error_codes": {},
"plan": "empresario",
"monthly_amount_cents": 3500,
"proration_amount_cents": 1750,
"account_id": "0199a1f0-1c22-7a10-b111-6a6b6c6d6e6f",
"customers_status": "queued",
"customers_queued": 3,
"name": "Talleres García SL",
"claim_token": "e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3",
"claim_url": "https://app.factuarea.com/account-claims/accept?token=e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3e3c3"
}
],
"own_company_customers": {
"status": "VALID",
"customers_queued": 12
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.