Accounting connections
Accounting synchronized records
Accounting tax rates
Accounting data pull
Analytics
Approval policies
Approval requests
Entity bank accounts
Cost centers
Counterparts
Counterpart addresses
Counterpart bank accounts
Counterpart contacts
Counterpart VAT IDs
Custom tax rates
Delivery notes
PDF templates
Documents
Entities
- GETGet all entities
- POSTCreate an entity
- GETGet the current entitydeprecated
- PATCHUpdate the current entitydeprecated
- GETGet an entity
- PATCHUpdate an entity
- POSTActivate an entity
- POSTDeactivate an entity
- GETGet entity settings
- PATCHUpdate entity settings
- GETGet an entity of this user
- PATCHUpdate an entity of this user
Payment methods
Entity users
Ledger accounts
Mail templates
Mailbox domains
Measure units
Overdue reminders
Credit notes
- GETGet credit notes
- POSTCreate a credit note
- POSTUpload a credit note from a file
- GETGet credit note validations
- PUTUpdate credit note validations
- POSTReset credit note validations
- GETGet a credit note by ID
- DELDelete a credit note
- PATCHUpdate a credit note
- POSTApprove a credit note
- POSTCancel a credit note
- POSTCancel OCR of a credit note
- GETGet all line items of a credit note
- PUTReplace all line items of a credit note
- POSTAdd a new line item to a credit note
- GETGet a single line item of a credit note
- DELDelete a line item from a credit note
- PATCHUpdate a line item of a credit note
- POSTReject a credit note
- POSTSubmit a credit note for approval
- GETValidate a credit note
Purchase orders
Payables
- GETGet payables
- POSTCreate a payable
- GETGet payables analyticsdeprecated
- POSTUpload a payable from a file
- GETGet payables validations
- PUTUpdate payables validations
- POSTReset payables validations
- GETGet the available variables for payable email templates
- GETGet a payable by ID
- DELDelete a payable
- PATCHUpdate a payable
- POSTApprove a payable for payment
- POSTAttach a file to a payable
- POSTCancel a payable
- POSTCancel OCR of a payable
- GETReturns the history of the specified accounts payable document.
- POSTMark a payable as paid
- POSTMark a payable as partially paid
- POSTReject a payable
- POSTReopen a rejected or waiting_to_be_paid payable
- POSTSubmit a payable for approval
- GETGet suggestions
- DELDelete suggestions
- POSTValidate a payable
Payable line items
Payment intents
Payment records
Payment reminders
Payment terms
Products
Projects
Receipts
- GETGet receipts
- POSTCreate a receipt
- POSTUpload a receipt from a file
- GETGet a receipt by ID
- DELDelete a receipt
- PATCHUpdate a receipt
- POSTAttach a file to a receipt
- GETGet all line items of a receipt
- POSTAdd a new line item to a receipt
- DELDelete a line item from a receipt
- PATCHUpdate a line item of a receipt
Receivables
- GETGet receivables
- POSTCreate a receivable
- GETGet required field names for invoice creation
- POSTSearch receivables
- GETGet email template variables
- GETGet a receivable by ID
- DELDelete a receivable
- PATCHUpdate a receivable
- POSTAccept a quote
- POSTCancel an invoice
- POSTClone a receivable
- POSTDecline a quote
- GETGet a receivable's history
- GETGet a receivable's history record by ID
- POSTIssue a receivable
- PUTUpdate the line items of a receivable
- GETGet a list of all mails sent by receivable
- GETGet a mail sent by receivable
- POSTMark an invoice as paid
- POSTMark an invoice as partially paiddeprecated
- POSTMark an invoice as uncollectible
- GETGet a link to the PDF version of a receivable
- POSTPreview a receivable's email message
- POSTSend a receivable via email
- POSTSend a test reminder
- POSTVerify a receivable
Text templates
Transactions
- GETGet transactions
- POSTCreate a transaction
- POSTCreate multiple transactions
- GETGet required fields configuration
- PUTUpdate required fields configuration
- GETGet a transaction
- DELDelete a transaction
- PATCHUpdate a transaction
- POSTApprove a transaction
- POSTReject a transaction
- POSTReopen a rejected transaction
- POSTSubmit a transaction for approval
- POSTValidate a transaction against required fields configuration
VAT rates
Webhook deliveries
Webhook subscriptions
Identity
- GETLists all departments for the caller's organization.
- POSTCreates a new department in the caller's organization.
- GETGets a department by ID.
- PUTUpdates a department in the caller's organization.
- DELDeactivates a department in the caller's organization.
- POSTBulk assigns or removes users from a department.
- PUTAssigns a user to a department.
- DELRemoves a user from a department.
- GETLists all locations for the caller's organization.
- POSTCreates a new location in the caller's organization.
- GETGets a location by ID.
- PUTUpdates a location in the caller's organization.
- DELDeactivates a location in the caller's organization.
- POSTBulk assigns or removes users from a location.
- PUTAssigns a user to a location.
- DELRemoves a user from a location.
- GETLists all applications across the caller's organization hierarchy with child organization type counts.
- GETGets an application by ID, including its scopes and enabled status.
- PATCHUpdates payment rail scopes for an application.
- POSTDisables an application.
- POSTEnables an application.
- GETLists organizations that have a relationship with the caller's organization.
- POSTCreates a new organization as a child of the caller's organization.
- GETGets all organization IDs visible to the caller by traversing the hierarchy downward.
- GETGets details for a specific organization.
- PATCHUpdates an organization's fields. Only provided fields are updated; omitted fields remain unchanged.
- POSTDisables an organization by setting its deactivation timestamp.
- POSTDisables all applications for an organization.
- GETGets disabled payment rails for an organization.
- PATCHUpdates payment rail status for an organization.
- POSTEnables an organization by clearing its deactivation timestamp.
- POSTEnables all applications for an organization.
- PUTUploads a logo for an organization.
- DELDeletes a logo for an organization.
- GETGets all applications for an organization.
- GETGets settings for an organization.
- PATCHUpdates settings for an organization.
- GETLists users from the target organization and all its descendants.
- POSTCreates a new user in the specified organization.
- GETGets a single user from a downstream organization in the hierarchy.
- PATCHUpdates profile fields for a user in a downstream organization.
- POSTDisables a user by setting their status to INACTIVE.
- POSTEnables a user by setting their status to ACTIVE.
Updates profile fields for a user in a downstream organization.
curl --request PATCH \
--url https://api.sandbox.tesouro.com/identity/v1/users/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"country": "<string>",
"isExpenseApprover": true,
"jobTitle": "<string>",
"name": "<string>",
"permissions": {
"grant": [
"<string>"
],
"revoke": [
"<string>"
]
},
"phoneNumber": "<string>",
"postalCode": "<string>",
"reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "ADMIN",
"stateOrProvince": "<string>"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "<string>",
"isExpenseApprover": true,
"name": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "ADMIN",
"status": "<string>",
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"country": "<string>",
"jobTitle": "<string>",
"phoneNumber": "<string>",
"postalCode": "<string>",
"reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"stateOrProvince": "<string>"
}Identity
Updates profile fields for a user in a downstream organization.
Requires user:profile:write (own org) or user:profile:write:all (cross-org). A caller cannot update their own profile.
Token types: APP, USER
PATCH
/
identity
/
v1
/
users
/
{id}
Updates profile fields for a user in a downstream organization.
curl --request PATCH \
--url https://api.sandbox.tesouro.com/identity/v1/users/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"country": "<string>",
"isExpenseApprover": true,
"jobTitle": "<string>",
"name": "<string>",
"permissions": {
"grant": [
"<string>"
],
"revoke": [
"<string>"
]
},
"phoneNumber": "<string>",
"postalCode": "<string>",
"reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "ADMIN",
"stateOrProvince": "<string>"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "<string>",
"isExpenseApprover": true,
"name": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "ADMIN",
"status": "<string>",
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"country": "<string>",
"jobTitle": "<string>",
"phoneNumber": "<string>",
"postalCode": "<string>",
"reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"stateOrProvince": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
APPTokenUSERToken
Application (M2M) OAuth2 access token (client credentials).
Path Parameters
The user ID to update.
Body
application/jsontext/jsonapplication/*+json
Cancellation token.
Explicit grant/revoke deltas for the user's permissions. Permissions not listed in either array are left untouched, so a caller managing only a subset of permissions does not have to round-trip every permission the target already holds.
Show child attributes
Show child attributes
The ID of the user's reporting manager. Three states: absent = leave unchanged, null = clear, value = set to the provided ID.
Available options:
ADMIN, BOOKKEEPER, EMPLOYEE, TREASURY_MANAGER Response
User updated successfully.
Available options:
ADMIN, BOOKKEEPER, EMPLOYEE, TREASURY_MANAGER Was this page helpful?
Gets a single user from a downstream organization in the hierarchy.Disables a user by setting their status to INACTIVE.
⌘I
Assistant
Responses are generated using AI and may contain mistakes.