> ## Documentation Index > Fetch the complete documentation index at: https://doc.youverify.co/llms.txt > Use this file to discover all available pages before exploring further. # Create Entity > Creates a new individual or business entity record for verification and monitoring purposes. ## OpenAPI ````yaml /api-reference/specs/cowork.json post /v2/api/entities openapi: 3.0.3 info: title: Youverify Cowork API version: 2.0.0 description: >- Entity, Activity, Signal and Case Management endpoints — the core Cowork platform object model. Assembled from doc.youverify.co/api-reference-sdk, endpoints kept in the exact order they appear in the GitBook navigation. Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid verification calls; 404 on lookup-by-ID calls) are sourced verbatim from Youverify's own "Youverify OS Error Codes" and "Response Codes" pages (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and attached via components.responses, since those pages document them account-wide rather than per endpoint. Any error example that a specific endpoint's own page actually showed is kept exactly as documented there instead of being replaced by these. contact: name: Youverify Support email: support@youverify.co servers: - url: https://api.youverify.co description: Production (live, billed) - url: https://api.sandbox.youverify.co description: Sandbox (test data, not billed) security: - ApiKeyAuth: [] tags: - name: Entity Management description: >- Create, retrieve and verify entities (individuals or businesses) — the core object every check attaches to. - name: Activity Management description: Inspect the verification activities run against your account. - name: Signal Management description: Retrieve monitoring signals and their events, by entity or business. - name: Case Management description: Create and manage compliance cases, including AI-generated case summaries. paths: /v2/api/entities: post: tags: - Entity Management summary: Create Entity description: >- Creates a new individual or business entity record for verification and monitoring purposes. operationId: createEntity parameters: - name: token in: header required: true schema: type: string description: API secret token requestBody: required: true content: application/json: schema: type: object properties: entityType: type: string description: Type of entity being created enum: - individual - business isSubjectConsent: type: boolean description: Must be true incorporationNumber: type: string description: Required if entityType is "business" incorporationName: type: string description: Required if entityType is "business" incorporationCountry: type: string description: 2-letter country code (businesses only) incorporationDate: type: string description: 'Format: YYYY-MM-DD (businesses only)' businessType: type: string description: Businesses only address: type: string description: Businesses only docLink: type: string description: Businesses only, link to registration document firstName: type: string description: Required if entityType is "individual" lastName: type: string description: Required if entityType is "individual" phone: type: string description: Required if entityType is "individual" email: type: string description: Individual or business gender: type: string description: Individual only dateOfBirth: type: string description: 'Format: YYYY-MM-DD (required for individuals)' nationality: type: string description: 2-letter code (required for individuals) imageUrl: type: string description: Link to uploaded image verifiedBy: type: string description: Verification source enum: - client required: - entityType - isSubjectConsent example: entityType: individual isSubjectConsent: true firstName: John lastName: Doe email: john.doe@example.com phone: '+2348012345678' gender: male dateOfBirth: '1990-01-01' nationality: NG imageUrl: http://someimage verifiedBy: client responses: '201': description: Success content: application/json: example: success: true status_code: 201 message: Entity created successfully. data: id: ent_684f5cc5a47a3926763b83a7 businessId: 61d880f1e8e15aaf24558f1a createdBy: firstName: Timothy lastName: Akinyelu middleName: '' id: 61f162ec1fd251c3a63f31c2 '401': $ref: '#/components/responses/Error401Unauthorized' '402': $ref: '#/components/responses/Error402PaymentRequired' '404': description: Not Found content: application/json: example: success: false statusCode: 404 message: You have attempted to get a resource that does not exist. name: ResourceNotFoundError data: {} '429': $ref: '#/components/responses/Error429TooManyRequests' '500': $ref: '#/components/responses/Error500ServerError' components: responses: Error401Unauthorized: description: Unauthorized — the token header is missing or invalid. content: application/json: example: success: false statusCode: 401 message: Permission denied name: UnauthorizedError data: {} Error402PaymentRequired: description: Payment Required — your account balance is too low to run this check. content: application/json: example: success: false statusCode: 402 message: Insufficient fund name: PaymentRequiredError data: {} Error429TooManyRequests: description: Too Many Requests — you have exceeded the rate limit; wait and retry. content: application/json: example: success: false statusCode: 429 message: Too many requests name: RateLimitError data: {} Error500ServerError: description: >- Internal Server Error — a rare, unexpected failure on Youverify's side. Contact support@youverify.co if it persists. content: application/json: example: success: false statusCode: 500 message: Internal Server Error name: Error data: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: token description: Your Youverify API secret key. Never expose client-side. ````