> ## Documentation Index > Fetch the complete documentation index at: https://docs.apostra.com/llms.txt > Use this file to discover all available pages before exploring further. # Convert account into an organization > Convert the current standalone account into an organization without creating another account. The account becomes the organization's only account; its contract, billing authority, entitlements, and any sales agent offering move to the organization; the confirming administrator becomes an organization administrator. Requires the account's own administrator in a signed-in session and explicit confirmation. Retrying resumes an unfinished conversion; a completed conversion returns its result. ## OpenAPI ````yaml /v2/buyer-api-v2.yaml post /accounts/convert-to-organization openapi: 3.0.0 info: title: Scope3 Buyer API version: 2.0.0 description: |- REST API for advertisers to manage advertisers, campaigns, and reporting. ## Authentication All endpoints require a Bearer token in the Authorization header: ``` Authorization: Bearer your-api-key ``` ## Base URL `https://api.apostra.com/api/v2/buyer` ## For AI Agents AI agents can use the MCP endpoint at `/mcp/v2/buyer` with three tools: - `initialize`: Start an MCP session - `api_call`: Make REST API calls - `ask_about_capability`: Learn about API features servers: - url: https://api.apostra.com/api/v2/buyer description: Production server security: [] tags: - name: Signup description: Request reviewed access to Interchange - name: Account description: Account management, service tokens, and preferences - name: Asks description: >- What you are waiting on Scope3 for — support, product, and supply asks in one list - name: Advertisers description: Manage advertisers - name: Product Discovery description: Discover and select products - name: Campaigns description: Manage advertising campaigns - name: Creatives description: Build, manage, and sync campaign creatives via AdCP Creative Protocol - name: Reporting description: Access performance metrics - name: Event Sources description: >- Manage event source configurations and log conversion/marketing events for attribution - name: Property Lists description: Validate property lists against AAO registry - name: Sales Agents description: View and connect sales agents - name: Measurement description: Measurement sources, records, context, and freshness - name: Syndication description: Syndicate resources to ADCP agents - name: Tasks description: Track async operation status - name: Buyer Billing description: >- Consolidated invoicing for buyers — invoices and pending invoice items issued by Scope3 across the buyer customer. - name: MCP description: Model Context Protocol endpoints for AI agents paths: /accounts/convert-to-organization: servers: - url: https://api.apostra.com/api/v2 description: Production server post: tags: - Account summary: Convert account into an organization description: >- Convert the current standalone account into an organization without creating another account. The account becomes the organization's only account; its contract, billing authority, entitlements, and any sales agent offering move to the organization; the confirming administrator becomes an organization administrator. Requires the account's own administrator in a signed-in session and explicit confirmation. Retrying resumes an unfinished conversion; a completed conversion returns its result. operationId: convertAccountToOrganization requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ConvertAccountToOrganizationBody' responses: '200': description: Convert account into an organization content: application/json: schema: $ref: '#/components/schemas/ConvertAccountToOrganizationResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- The caller is not this account's administrator, or the session is impersonated, support-assisted, Scope3 staff, an API key, or a service credential. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- The account already belongs to an organization, or its conversion is already running. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: ConvertAccountToOrganizationBody: type: object properties: confirmOrganizationConversion: type: boolean enum: - true description: >- Must be true after presenting that the conversion creates an organization, attaches this account to it as the organization's only account, moves contract and billing authority to the organization, makes the confirmer an organization administrator, keeps existing members account-only, applies account-specific standing before inherited organization standing, and cannot be undone without a dedicated migration. example: true organizationName: description: Name for the new organization. Defaults to the account's name. example: Acme HQ type: string minLength: 1 maxLength: 255 required: - confirmOrganizationConversion additionalProperties: false description: >- Request body for converting the current standalone account into an organization ConvertAccountToOrganizationResponse: type: object properties: organizationId: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 description: Customer ID of the new organization. example: 812 accountId: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 description: >- Customer ID of the converted account, now the organization's account. example: 105 alreadyCompleted: type: boolean description: >- True when the account had already been converted and this call returned that result. example: false required: - organizationId - accountId - alreadyCompleted additionalProperties: false description: Result of converting a standalone account into an organization ErrorResponse: type: object properties: data: type: string nullable: true enum: - null error: $ref: '#/components/schemas/ApiError' required: - data - error additionalProperties: false description: Standard error response ApiError: type: object properties: code: type: string description: Machine-readable error code message: type: string description: Human-readable error message field: description: Field path associated with the error type: string details: description: Additional error context type: object additionalProperties: {} required: - code - message additionalProperties: false description: Structured error object securitySchemes: bearerAuth: type: http scheme: bearer description: API key or access token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.