Create Seller profile
POST/v1/sellers
Creates a new Seller profile in the FCC Marketplace. The profile starts in PENDING_VERIFICATION
status and transitions to ACTIVE once the marketplace completes KYC verification.
This operation is not idempotent. Submitting the same payload twice creates a duplicate
draft. Use the returned sellerId to reference this Seller in all subsequent calls.
Required pre-condition: A valid Bearer token obtained via the OAuth endpoint.
Side effects: A verification workflow is triggered automatically upon successful creation. The Seller's registered email will receive a confirmation and next-step instructions.
Returns 409 if a Seller profile already exists for the same emailId.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 500
Seller profile created successfully.
Request body failed validation. See details for field-level errors.
Bearer token is absent or expired. Re-authenticate via the OAuth endpoint.
The authenticated application does not have permission to create Seller profiles.
A Seller with the same businessRegistrationNumber already exists.
Request is syntactically valid but semantically incorrect (e.g., invalid tax ID format).
Internal server error. Retry with exponential backoff.