Skip to content

API Documentation

ConceptsThe Worklayer platformAuthentication

MemberThe Member ResourceCreate a memberRetrieve a list of membersUpdate a member

JobsThe Job ResourceThe job creation flowThe Info Gathering ChecklistCreate a job from a templateRetrieve questionnaireSubmit questionnaire answersRequest a specific ProRequest a previous ProSubmit a jobRetrieve a list of your jobsList job documentsDelete a jobRetrieve a job checklistComplete info gathering for a job

ConsultationsThe Consultation Resource

Scope Change RequestsChange job scopeList consultation service itemsCreate job scope change requestApprove a job scope changeReject a job scope change

Job TemplatesThe Job Template ResourceRetrieve available job templates

Personal ProfilesThe Personal Profile ResourceRetrieve a personal profileSave a personal profileProvide a personal profile to a jobRetrieve a personal profile for a job

Spousal ProfilesThe Spousal Profile ResourceRetrieve a spousal profileSave a spousal profileProvide a spousal profile to a jobRetrieve a spousal profile for a job

Dependent ProfilesThe Dependent Profile ResourceList dependent profilesRetrieve a dependent profileCreate a dependent profileUpdate a dependent profileDelist a dependent profileProvide a dependent profile to a jobRemove a dependent profile from a jobRetrieve dependent profiles for a job

Business ProfilesThe Business Profile ResourceList business profilesCreate a business profileUpdate a business profileRetrieve a business profileRetrieve a business profile for a jobDelist a business profileProvide a business profile to a job

Tax Refund MethodsThe Tax Refund Method ResourceList tax refund methodsCreate a tax refund methodRetrieve a tax refund methodRetrieve a tax refund method for a jobUpdate a tax refund methodDelist a tax refund methodProvide a personal refund methodProvide a business refund method

DocumentsThe Document ResourceCreate a documentGet a documentDownload a document

Document TypesThe Document Type ResourceList document types

MessagesThe Message ResourceSend a messageList messages

WebhooksConsume webhook eventsEvent resourcesCheck signatures

Magic LinkDashboardJob Details

GuidesFilteringPostman Collection

Message

Resource representing a message linked to a job in your workspace.

The Message resource represents a communication exchanged between a user and a Taxfyle Pro within the context of a job. Messages can be sent and received throughout the lifetime of a job as long as the job hasn’t been Closed or Canceled.

When a message is sent, it is associated with the appropriate job member.

The Message APIs allow you to post messages to a job, retrieve the full message history of a job, and access message content.

Endpoints

Method	Url
`GET`	`/v1.0/jobs/{job_id}/messages`
`POST`	`/v1.0/jobs/{job_id}/messages`

Message Properties

id

The message's ID.

text

The message's text.

sender_user_id

The unique identifier of the job member who sent the message.

create_time

When the message was created. A timestamp in format 2025-07-15T13:45:25.781Z.

Copied
1{
2  "id": "499d692d-67aa-4127-a45c-b9e27f54afad",
3  "text": "Message's text",
4  "sender_user_id": "4e5ccdf6-a9e1-4025-bff1-96cfc105b2a6",
5  "create_time": "2025-07-15T13:45:25.781Z"
6}

Next steps

Last updated on July 15, 2025

Privacy Policy Terms & Conditions© 2025 Taxfyle