> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wfa.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an assessment

> Submit trip or hiring details and receive an assessment identifier.



## OpenAPI

````yaml /openapi.json post /rwa_create
openapi: 3.1.0
info:
  title: WFA API
  version: test
  description: >-
    Draft Bubble test contract. Required inputs, exact envelopes and HTTP error
    statuses need verification before production.
servers:
  - url: https://wfa-team-tool-v1.bubbleapps.io/version-test/api/1.1/wf
    description: Bubble test environment
security:
  - companyToken: []
paths:
  /rwa_create:
    post:
      tags:
        - Assessments
      summary: Create an assessment
      description: Submit trip or hiring details and receive an assessment identifier.
      operationId: rwa_create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                purpose:
                  type: string
                  description: >-
                    Work From Anywhere or Hire From Anywhere. Purpose affects
                    the applicable inputs.
                  example: Work From Anywhere
                seniority:
                  type: string
                  description: Seniority selection. Low is shown in the documented example.
                  example: Low
                roleType:
                  type: string
                  description: Role selection. Other is shown in the documented example.
                  example: Other
                citizenship:
                  type: string
                  description: Employee citizenship. Use the exact supported country name.
                  example: Australia
                destination:
                  type: string
                  description: Destination country. Use the exact supported country name.
                  example: Argentina
                residency:
                  type: string
                  description: >-
                    Employee residency country. Use the exact supported country
                    name.
                  example: Australia
                salesContracts:
                  type: string
                  description: Sales contract activity; documented example uses Yes.
                  example: 'Yes'
                pastTripsDuration:
                  type: integer
                  description: Duration of prior trips.
                  example: 0
                legalRight:
                  type: string
                  description: Existing right to work; documented example uses No.
                  example: 'No'
                benefitLocalMarket:
                  type: string
                  description: Local market activity; documented example uses No.
                  example: 'No'
                urgency:
                  type: string
                  description: Timing selection; documented example uses 1-3 months.
                  example: 1-3 months
                numberHires:
                  type: integer
                  description: Number of hires.
                  example: 5
                startDate:
                  type: string
                  description: Start date in ISO 8601 format.
                  example: '2026-11-01T00:00:00.000Z'
                endDate:
                  type: string
                  description: End date in ISO 8601 format; must be on or after the start.
                  example: '2026-11-10T00:00:00.000Z'
                workingDays:
                  type: integer
                  description: Working days within the trip dates.
                  example: 5
                employeeId:
                  type: string
                  description: Your external employee Staff ID.
                  example: STAFF-001
                complianceTeamMemberId:
                  type: string
                  description: >-
                    Registered, activated compliance Staff ID in the token’s
                    company.
                managerId:
                  type: string
                  description: External manager Staff ID.
            example:
              purpose: Work From Anywhere
              seniority: Low
              roleType: Other
              citizenship: Australia
              destination: Argentina
              residency: Australia
              salesContracts: 'Yes'
              pastTripsDuration: 0
              legalRight: 'No'
              benefitLocalMarket: 'No'
              urgency: 1-3 months
              numberHires: 5
              startDate: '2026-11-01T00:00:00.000Z'
              endDate: '2026-11-10T00:00:00.000Z'
              workingDays: 5
              employeeId: STAFF-001
      responses:
        '200':
          description: >-
            Workflow response. Check the JSON status: HTTP 200 can include an
            application error. Other HTTP error statuses have not yet been
            verified.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: >-
                      Contains assessment_id and redirect_url. Exact nesting and
                      envelope pending verification; no sample success payload
                      supplied.
                  - type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - error
                      success:
                        type: boolean
                        const: false
                      message:
                        type: string
                      errors:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
              examples:
                invalidToken:
                  summary: Invalid token
                  value:
                    status: error
                    success: false
                    message: Invalid authorization token
components:
  securitySchemes:
    companyToken:
      type: http
      scheme: bearer
      description: Your company API token. Keep it on your server.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.