Skip to content

Jobs Creation Flow

Learn how to create jobs, answer questions, and submit them to the pool of Tax Pros.

The process of creating jobs for your users and submitting them to the pool of Tax Pros breaks down into four steps explained in detail below:

  1. Create an under-construction job from a job template for one of your users.
  2. Provide the required information as per the questionnaire.
  3. Request a previous Pro (optional).
  4. Submit the job to the pool of providers.

Endpoints Used

MethodUrl
GET/v1.0/job-templates
POST/v1.0/jobs
POST/v1.0/jobs/{job_id}/requested-provider/request-previous
POST/v1.0/jobs/{job_id}/submit

Create an under-construction job from a job template

To create an under-construction job for a user, you'll need two things:

  1. The ID of the user you want to create the job for
  2. The ID of the job template you want to use

You can get a job template ID from the list of available job templates in your workspace by calling the List Job Templates API and noting a job template ID.

Once you have the user ID and the job template ID, you can use the Create Job API to create an under-construction job for your user. You'll get a job ID that you can use to retrieve information about the job that will be used to create links, answer questions, and submit to the pool of Tax Pros.

Provide the required information as per the Questionnaire.

Query for the questionnaire and provide the required answers. The questionnaire will be complete when all required answers for a valid path have been provided.

Request a previous Pro (Optional)

If you want to request a previous Pro to work on the job, you can use the Request Previous Pro endpoint to do so. This must be done prior to submitting the job. Note that this is only applicable for returning customers, as their job history is used to determine which Pro to request.

Please note that even if a specific Pro is requested, they are not guaranteed to be the one assigned to the job If they are not available, the job will be picked up by the first available Pro.

Submit the job to the pool of providers

At this point, you've provided all the answers for the required questions in your desired service packages. Next, you can provide any supporting documents like the previous year's return or form of identification via the Document Creation API, or you can submit the job to the pool of Taxfyle Pros via the Job Submit Endpoint.

Once the job is submitted, it'll transition to the UNCLAIMED status while awaiting being picked up by a matching pro and will then transition to CLAIMED once in progress. If Info Gathering is enabled in the workspace, it'll transition to INFO_GATHERING before UNCLAIMED. Info Gathering guides the Client through providing all required information via the Info Gathering Checklist.

Last updated on April 16, 2025