Skip to content

API Documentation

ConceptsThe Worklayer platformAuthenticationRate LimitsError handling

MemberThe Member ResourceCreate a memberRetrieve a memberRetrieve a member by external IDRetrieve a list of membersUpdate a memberAccept terms for a member

JobsThe Job ResourceRetrieve a job by short IDThe job creation flowThe Info Gathering ChecklistCreate a job from a templateRetrieve questionnaireSubmit questionnaire answersRequest a specific ProRequest a previous ProAssign a supporting clientRemove a supporting clientSubmit a jobRetrieve a list of your jobsList job documentsDelete a jobRetrieve a job checklistComplete info gathering for a jobRequest cancellationRequest reopen

Relationship ManagerRelationship Manager ResourceRetrieve a job relationship manager

Job ProgressionsApprove a draftReject a draftMark job as ready to file

ConsultationsThe Consultation Resource

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

Job NotesThe Job Note ResourceCreate a job noteGet a job noteList job notes

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 documentDelete a document

Document TypesThe Document Type ResourceList document types

MessagesThe Message ResourceSend a messageList messagesGet unread count

OCRStart OCR processingGet OCR results

WebhooksConsume webhook eventsEvent resourcesCheck signatures

Magic LinkDashboardJob DetailsWaitlist

PortalPortal embeddingPortal translations

GuidesFilteringPostman Collection

Update Business Profile

Update an existing business profile.

This endpoint updates an existing business profile. It allows modifying business identification details and contact information.

Please note that all properties are replaced with the values from the request payload. If a property is not specified, it will be replaced with an empty value.

Any change results in a new version.

Endpoint

Method	Url
`PUT`	`/v1.0/business-profiles/:profile_id`

Path Parameters

profile_id

•

string

required

The unique identifier of the profile to update.

Request Body

Warning

Given this is a PUT, when a property is omitted, it will be defaulted to null. This applies to nested objects as well. For example, if the existing profile has a contact_info.phone_number defined, if omitted from the next update request, the property will be set to null.

business_info

•

object

required

Object containing the business's identification information. See the business info object.

contact_info

•

object

Object containing the business's contact details. See the contact info object.

Sample Request

bashCopied
1curl -X PUT 'https://api.worklayer.com/v1.0/business-profiles/3b31f309-93ad-463a-ad1d-c39cac1c0a3d' \
2-H 'Authorization: Bearer {token}' \
3-H 'Content-Type: application/json' \
4-d '{
5  "business_info": {
6    "business_name": "Acme Corporation",
7    "date_of_incorporation": "01/01/2020",
8    "employer_identification_number": "12-3456789"
9  },
10  "contact_info": {
11    "email": "contact@acme.com",
12    "phone_number": "+1-555-555-5555",
13    "address": {
14      "address_line_1": "123 Business Ave",
15      "address_line_2": "Suite 100",
16      "city": "Miami",
17      "region": "FL",
18      "postal_code": "33134",
19      "country": "United States"
20    }
21  }
22}'

Response

id

•

string

Unique identifier of the updated profile.

version

•

integer

Version number of the updated profile.

Sample Response

jsonCopied
1{
2  "id": "3b31f309-93ad-463a-ad1d-c39cac1c0a3d",
3  "version": 2
4}

Errors

400: Invalid request body
403: You're not allowed to update the profile
404: Profile not found

Next steps

Provide a business profile to a job

Last updated on December 9, 2024

Privacy Policy Terms & Conditions© 2026 Taxfyle