> ## Documentation Index > Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt > Use this file to discover all available pages before exploring further. # Create Revenue Split > Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits. Add a new Revenue Split The header `X-User-Id` must be provided for this endpoint in order to create a Revenue Split on behalf of users. Revenue Splits by Default are not locked (not active), until confirmed by both parties. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/splits openapi: 3.1.0 info: title: SpaceMedia Public API version: 1.0.0 description: >- Production public API reference for SpaceMedia organization admins, permitted team members, end users, and API clients. The spec excludes SpaceMedia system/backoffice routes and cross-organization selectors. contact: name: SpaceMedia Support email: whitelabel@spacemedia.uk url: https://spacemedia.uk/contact servers: - url: https://enterprise.spacemedia.uk description: Production security: - bearerAuth: [] tags: - name: Authentication description: 'Access: API client credential flow.' x-mint: icon: key - name: Account Settings description: 'Access: authenticated organization user.' x-mint: icon: settings - name: Reference Data description: 'Access: authenticated organization users and API clients.' x-mint: icon: globe - name: Artists description: >- Access: organization users with artist permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: mic - name: Releases description: >- Access: organization users with release permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: disc - name: Tracks description: >- Access: organization users with track permissions; `X-User-Id` may target a same-organization user where allowed. x-mint: icon: music - name: Revenue Splits description: >- Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits. x-mint: icon: percent - name: User Management description: >- Access: organization admins or users allowed by user policies. Cross-organization selectors are excluded from this public spec. x-mint: icon: users - name: Plans & Upgrades description: >- Access: organization admins for plan lists; authenticated end users for upgrade options. x-mint: icon: package - name: Billing & Checkouts description: >- Access: authenticated organization users. Gateway availability depends on organization settings. x-mint: icon: credit-card - name: Add-On Management description: 'Access: organization admins for add-on checkout and lifecycle actions.' x-mint: icon: blocks - name: Copyright Management description: >- Access: organization admins or users with copyright wallet and release access. System-only provider and adjustment actions are excluded. x-mint: icon: shield-check - name: Quality Control description: 'Access: organization admins with release processing permission.' x-mint: icon: clipboard-check paths: /api/v1/splits: post: tags: - Revenue Splits summary: Create Revenue Split description: >- Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits. Add a new Revenue Split The header `X-User-Id` must be provided for this endpoint in order to create a Revenue Split on behalf of users. Revenue Splits by Default are not locked (not active), until confirmed by both parties. operationId: createARevenueSplit parameters: - name: Accept in: header required: false description: Use `application/json` for API responses. schema: type: string example: application/json - name: Authorization in: header required: false description: Bearer access token. Use `Bearer `. schema: type: string example: Bearer - in: header name: X-User-Id description: >- Optional user UUID to perform the request on behalf of a user in the same organization. example: 42e6f4a8-9b12-4f7a-8c55-9d7f6a2b1234 schema: type: string requestBody: required: true content: application/json: schema: type: object additionalProperties: true example: title: Midnight Signals Writer Share beneficiary_id: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b percentage: 25 start_date: '2026-05-01' end_date: '2026-12-31' releases: - 10401 tracks: - 20401 responses: '200': description: Success content: application/json: schema: type: object additionalProperties: true example: success: true data: id: a99f63b8-7df7-4091-a0e0-f9327ff7c8d1 title: Midnight Signals Writer Share percentage: 25 start_date: '2026-05-01T00:00:00+00:00' end_date: '2026-12-31T00:00:00+00:00' locked: false beneficiary: id: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b uuid: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 name: Eli Brooks full_name: Eli Brooks first_name: Eli last_name: Brooks email: eli.brooks@example.test phone: '+442071838750' language: en country: United Kingdom address: 22 Demo Lane, London photo: null profile_photo: null verified: true email_verified_at: '2026-04-10T08:15:00+00:00' last_login_at: '2026-04-18T08:45:00+00:00' created_at: '2026-03-20T09:00:00+00:00' updated_at: '2026-04-18T08:45:00+00:00' is_suspended: false suspended_at: null invitation_status: accepted is_invited: false roles: - id: role-admin-demo uuid: role-admin-demo name: Admin creator: id: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2 uuid: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2 organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4 name: Maya Chen full_name: Maya Chen first_name: Maya last_name: Chen email: maya.chen@example.test phone: '+442071838750' language: en country: United Kingdom address: 22 Demo Lane, London photo: null profile_photo: null verified: true email_verified_at: '2026-04-10T08:15:00+00:00' last_login_at: '2026-04-18T08:45:00+00:00' created_at: '2026-03-20T09:00:00+00:00' updated_at: '2026-04-18T08:45:00+00:00' is_suspended: false suspended_at: null invitation_status: accepted is_invited: false roles: - id: role-admin-demo uuid: role-admin-demo name: Admin '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/ValidationError' security: - bearerAuth: [] components: responses: Unauthorized: description: Unauthorized content: application/json: example: success: false message: Missing bearer token Forbidden: description: Forbidden content: application/json: example: success: false message: This action is unauthorized. NotFound: description: Not found content: application/json: example: success: false message: Resource not found ValidationError: description: Validation error content: application/json: example: success: false message: Validation failed. errors: title: - The title field is required. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Sanctum token ````