# Latest **URL:** https://stack.deel.com/latest.md [Latest](https://stack.deel.com/latest.md) · [Categories](https://stack.deel.com/categories.md) · [Tags](https://stack.deel.com/tags.md) --- ## [Tips for Getting Started](https://stack.deel.com/t/tips-for-getting-started/20)
**Author:** [@Cassy\_Deel](https://stack.deel.com/u/Cassy_Deel)\ **Replies:** 0\ **Last updated:** [August 2, 2024, 2:35pm UTC](https://stack.deel.com/t/tips-for-getting-started/20 "2024-08-02T14:35:07Z")
Hello and welcome to the Deel Developer Community! We’re excited to have you join us in this vibrant space designed for developers to connect, collaborate, and grow together. Why We Created This Community To continue in… --- ## [Where to report security vulnerabilities](https://stack.deel.com/t/where-to-report-security-vulnerabilities/539)
**Author:** [@domaccount](https://stack.deel.com/u/domaccount)\ **Replies:** 1\ **Last updated:** [August 19, 2026, 12:08pm UTC](https://stack.deel.com/t/where-to-report-security-vulnerabilities/539 "2026-08-19T12:08:03Z")
Hi, Can you please update this document: https://www.deel.com/.well-known/security.txt Ideally, it should point out directly where to report security vulnerabilities instead of linking a website which again, says nothi… --- ## [Index row size 2856 exceeds btree when using OAuth to connect to MCP server](https://stack.deel.com/t/index-row-size-2856-exceeds-btree-when-using-oauth-to-connect-to-mcp-server/538)
**Author:** [@Krzysztof](https://stack.deel.com/u/Krzysztof)\ **Replies:** 0\ **Last updated:** [July 27, 2026, 10:07am UTC](https://stack.deel.com/t/index-row-size-2856-exceeds-btree-when-using-oauth-to-connect-to-mcp-server/538 "2026-07-27T10:07:47Z")
Org name: Doxy.me Details: We’re integrating with Deel’s MCP server (https://api.letsdeel.com/mcp) via OAuth. Discovery, dynamic client registration, and user authorization all succeed. The failure happens only at… --- ## [\[URGENT\] POST /rest/v2/contracts returns 403 TOKEN\_TYPE\_NOT\_ALLOWED with personal API token (contracts:write)](https://stack.deel.com/t/urgent-post-rest-v2-contracts-returns-403-token-type-not-allowed-with-personal-api-token-contracts-write/532)
**Author:** [@tundx0](https://stack.deel.com/u/tundx0)\ **Replies:** 0\ **Last updated:** [June 1, 2026, 4:21pm UTC](https://stack.deel.com/t/urgent-post-rest-v2-contracts-returns-403-token-type-not-allowed-with-personal-api-token-contracts-write/532 "2026-06-01T16:21:03Z")
Summary When we create a contractor contract via POST /rest/v2/contracts using a personal API token with contracts:write (and related scopes), Deel responds with HTTP 403 and error code TOKEN\_TYPE\_NOT\_ALLOWED / message “… --- ## [API Versioning and lifecycle states are now available](https://stack.deel.com/t/api-versioning-and-lifecycle-states-are-now-available/525)
**Author:** [@mark\_deel](https://stack.deel.com/u/mark_deel)\ **Replies:** 0\ **Last updated:** [May 7, 2026, 7:22am UTC](https://stack.deel.com/t/api-versioning-and-lifecycle-states-are-now-available/525 "2026-05-07T07:22:35Z")
Hey everyone, We’re excited to share that we’ve shipped API versioning and lifecycle states—giving developers more control and confidence when building on the Deel API. Until now, shipping new functionality meant askin… --- ## [Missing first\_name, last\_name, emails and other fields in the API](https://stack.deel.com/t/missing-first-name-last-name-emails-and-other-fields-in-the-api/519)
**Author:** [@Kombo](https://stack.deel.com/u/Kombo)\ **Replies:** 2\ **Last updated:** [February 20, 2026, 8:17am UTC](https://stack.deel.com/t/missing-first-name-last-name-emails-and-other-fields-in-the-api/519 "2026-02-20T08:17:53Z")
Hi team! I’m calling an endpoint /v2/people/:id and receiving a limited set of data about the person. What’s missing comparing to the “normal” set of data: Addresses Birth date Country Emails First name … --- ## [Invoice Adjustments are being automatically approved during their creation](https://stack.deel.com/t/invoice-adjustments-are-being-automatically-approved-during-their-creation/497)
**Author:** [@javier.maso](https://stack.deel.com/u/javier.maso)\ **Replies:** 5\ **Last updated:** [February 11, 2026, 2:36pm UTC](https://stack.deel.com/t/invoice-adjustments-are-being-automatically-approved-during-their-creation/497 "2026-02-11T14:36:18Z")
Org name: DevBase Detailed description of the issue and where it occurs: Hi, since some point between 9AM and 5PM of December 22th, the invoice adjustments we are sending through the API are being automatically appr… --- ## [How to Download Attachments from Invoice Adjustments via Deel API?](https://stack.deel.com/t/how-to-download-attachments-from-invoice-adjustments-via-deel-api/507)
**Author:** [@simon](https://stack.deel.com/u/simon)\ **Replies:** 1\ **Last updated:** [February 11, 2026, 10:41am UTC](https://stack.deel.com/t/how-to-download-attachments-from-invoice-adjustments-via-deel-api/507 "2026-02-11T10:41:52Z")
Hi I’m using the Deel Invoice Adjustment API to manage “work” type adjustments, which include attachments (e.g., screenshots). The adjustment JSON provides a filename and key, but I cannot find an endpoint or parameter … --- ## [Need help changing email set for API Sandbox account](https://stack.deel.com/t/need-help-changing-email-set-for-api-sandbox-account/506)
**Author:** [@sandboxes](https://stack.deel.com/u/sandboxes)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 4:11pm UTC](https://stack.deel.com/t/need-help-changing-email-set-for-api-sandbox-account/506 "2026-02-09T16:11:32Z")
Bug Reporting Template Org name: Merge We’re running into an OAuth linking issue with Deel Sandbox accounts and wanted to confirm the correct setup. Context: Our Deel Sandbox account is currently associated with: t… --- ## [Contract amends history](https://stack.deel.com/t/contract-amends-history/492)
**Author:** [@CrisSH](https://stack.deel.com/u/CrisSH)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 4:03pm UTC](https://stack.deel.com/t/contract-amends-history/492 "2026-02-09T16:03:18Z")
Hello everyone! We’re working on building a custom dashboard powered by Deel data, and I’m running into a question I haven’t been able to solve through the documentation. Is there any way to retrieve past contract agre… --- ## [How to get the worker:read scope for EOR compliance document endpoints?](https://stack.deel.com/t/how-to-get-the-worker-read-scope-for-eor-compliance-document-endpoints/509)
**Author:** [@mitcf](https://stack.deel.com/u/mitcf)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 3:46pm UTC](https://stack.deel.com/t/how-to-get-the-worker-read-scope-for-eor-compliance-document-endpoints/509 "2026-02-09T15:46:24Z")
Hi All, I’m looking at an integration to pull EOR compliance documents via the API. The https://developer.deel.com/api/eor-worker-endpoints/eor-worker-compliance/download-compliance-document requires the worker:read sc… --- ## [How to update an employee's time off allowance](https://stack.deel.com/t/how-to-update-an-employees-time-off-allowance/491)
**Author:** [@Steve.Price](https://stack.deel.com/u/Steve.Price)\ **Replies:** 1\ **Last updated:** [October 3, 2025, 9:36am UTC](https://stack.deel.com/t/how-to-update-an-employees-time-off-allowance/491 "2025-10-03T09:36:17Z")
Hello, currently we manage our time-off bookings via another system, we need to record time-off in Deel for payroll reasons. I have been able to use the API endpoints available to create, update and delete time-off withi… --- ## [OAuth Auntification](https://stack.deel.com/t/oauth-auntification/487)
**Author:** [@IronRat](https://stack.deel.com/u/IronRat)\ **Replies:** 1\ **Last updated:** [September 23, 2025, 8:49am UTC](https://stack.deel.com/t/oauth-auntification/487 "2025-09-23T08:49:12Z")
Hi, When I tested OAuth 2.0 authentication, I noticed an issue. After entering my credentials, the loading screen keeps spinning and nothing happens. Additionally, I found that if the redirect\_uri does not exactly matc… --- ## [403 code for List payroll events by legal entity](https://stack.deel.com/t/403-code-for-list-payroll-events-by-legal-entity/486)
**Author:** [@Deepak\_05082002](https://stack.deel.com/u/Deepak_05082002)\ **Replies:** 1\ **Last updated:** [September 23, 2025, 8:47am UTC](https://stack.deel.com/t/403-code-for-list-payroll-events-by-legal-entity/486 "2025-09-23T08:47:41Z")
Hi team, I’m trying to integrate with the Deel API but I keep getting a 403 Forbidden response. My request looks like this: Endpoint: legal-entities/{id}/reports Method: GET Headers: I’m including the Authoriz… --- ## [Field labels for "Local Bank Account" (Uruguay) are not displayed correctly when adding a withdrawal method.](https://stack.deel.com/t/field-labels-for-local-bank-account-uruguay-are-not-displayed-correctly-when-adding-a-withdrawal-method/481)
**Author:** [@piapia](https://stack.deel.com/u/piapia)\ **Replies:** 1\ **Last updated:** [September 10, 2025, 9:25am UTC](https://stack.deel.com/t/field-labels-for-local-bank-account-uruguay-are-not-displayed-correctly-when-adding-a-withdrawal-method/481 "2025-09-10T09:25:21Z")
When trying to add a Local Bank Account withdrawal method for Uruguay, in step “Add details”, the fields display internal keys instead of user-friendly labels. This breaks usability since users don’t know what informatio… --- ## [Is there a way to retrieve a candidate’s id and link fields via API after creation?](https://stack.deel.com/t/is-there-a-way-to-retrieve-a-candidate-s-id-and-link-fields-via-api-after-creation/484)
**Author:** [@blili](https://stack.deel.com/u/blili)\ **Replies:** 1\ **Last updated:** [September 10, 2025, 9:12am UTC](https://stack.deel.com/t/is-there-a-way-to-retrieve-a-candidate-s-id-and-link-fields-via-api-after-creation/484 "2025-09-10T09:12:12Z")
Hi all, I’m using the Onboarding API to create candidates in Deel. When creating a candidate, I supply our own id (unique identifier in our ATS) and a link (unique ATS URL) to the candidate’s profile in our system. Acco… --- ## [New Feature: Webhook Simulation](https://stack.deel.com/t/new-feature-webhook-simulation/485)
**Author:** [@Cassy\_Deel](https://stack.deel.com/u/Cassy_Deel)\ **Replies:** 0\ **Last updated:** [August 29, 2025, 9:20pm UTC](https://stack.deel.com/t/new-feature-webhook-simulation/485 "2025-08-29T21:20:17Z")
:waving\_hand: Hi Developer community, we’ve got another exciting update to share today! We’re announcing the new Webhook Simulation—a new capability designed to make testing and validating your webhook integrations safe… --- ## [How do you trigger a workflow manually?](https://stack.deel.com/t/how-do-you-trigger-a-workflow-manually/474)
**Author:** [@gcambridge](https://stack.deel.com/u/gcambridge)\ **Replies:** 2\ **Last updated:** [August 29, 2025, 9:11pm UTC](https://stack.deel.com/t/how-do-you-trigger-a-workflow-manually/474 "2025-08-29T21:11:03Z")
We’re using workflows to trigger webhooks but testing them is very hard as there’s no way to trigger a workflow manually. How do you recommend we trigger workflows. Is there any way to trigger a workflow manually? Thank… --- ## [New Feature: Webhook Monitoring Dashboard](https://stack.deel.com/t/new-feature-webhook-monitoring-dashboard/483)
**Author:** [@Cassy\_Deel](https://stack.deel.com/u/Cassy_Deel)\ **Replies:** 0\ **Last updated:** [August 25, 2025, 4:19am UTC](https://stack.deel.com/t/new-feature-webhook-monitoring-dashboard/483 "2025-08-25T04:19:47Z")
:waving\_hand: Hi Developer community, we’ve got some exciting news to share today! We recently released the Webhook Monitoring Dashboard—a new interface that provides detailed visibility into webhook events, statuses, a… --- ## [When Filters / Query Params are passed into GET Contracts List, the value against total\_rows is incorrect](https://stack.deel.com/t/when-filters-query-params-are-passed-into-get-contracts-list-the-value-against-total-rows-is-incorrect/458)
**Author:** [@Vineet](https://stack.deel.com/u/Vineet)\ **Replies:** 1\ **Last updated:** [August 12, 2025, 9:57am UTC](https://stack.deel.com/t/when-filters-query-params-are-passed-into-get-contracts-list-the-value-against-total-rows-is-incorrect/458 "2025-08-12T09:57:38Z")
Org name: Oahi WFM (Tambla WFM) Detailed description of the issue and where it occurs: Instance Login Email: oahidemo2@letsdeel.co User GET Contracts List API to fetch global\_payroll contracts where status is “in\_prog… --- ## [Spike in 500s on /people endpoint](https://stack.deel.com/t/spike-in-500s-on-people-endpoint/465)
**Author:** [@catiegrasse](https://stack.deel.com/u/catiegrasse)\ **Replies:** 5\ **Last updated:** [July 31, 2025, 1:54am UTC](https://stack.deel.com/t/spike-in-500s-on-people-endpoint/465 "2025-07-31T01:54:45Z")
Bug Reporting Template When submitting a bug report, please be sure to include the fields below. Never share any personal data or email details publicly. An admin may reach out via direct message to get more details fro… --- ## [Problem logging expenses through API](https://stack.deel.com/t/problem-logging-expenses-through-api/450)
**Author:** [@javier.maso](https://stack.deel.com/u/javier.maso)\ **Replies:** 2\ **Last updated:** [July 3, 2025, 4:08pm UTC](https://stack.deel.com/t/problem-logging-expenses-through-api/450 "2025-07-03T16:08:34Z")
Org name: DevBase Detailed description of the issue and where it occurs: Yesterday morning (June 25th, 11:17AM GMT -3) we started getting errors while trying to log expenses through the API by using the “Create an invoi… --- ## [Annual / Hourly Gross Salary Retrieval via Sandbox API](https://stack.deel.com/t/annual-hourly-gross-salary-retrieval-via-sandbox-api/448)
**Author:** [@sim\_singh](https://stack.deel.com/u/sim_singh)\ **Replies:** 4\ **Last updated:** [July 3, 2025, 12:17pm UTC](https://stack.deel.com/t/annual-hourly-gross-salary-retrieval-via-sandbox-api/448 "2025-07-03T12:17:57Z")
How can I retrieve the annual gross salary (or base salary) for a global\_payroll contract in the sandbox environment via the sandbox API? I am trying to run some testing for a script to call the API and match a personal … --- ## [Tokens endpoint through error when requesting for new access token using Postman](https://stack.deel.com/t/tokens-endpoint-through-error-when-requesting-for-new-access-token-using-postman/442)
**Author:** [@Vineet](https://stack.deel.com/u/Vineet)\ **Replies:** 4\ **Last updated:** [June 26, 2025, 1:04am UTC](https://stack.deel.com/t/tokens-endpoint-through-error-when-requesting-for-new-access-token-using-postman/442 "2025-06-26T01:04:27Z")
Org name: Tambla WFM (Oahi WFM) Detailed description of the issue and where it occurs: Using Postman, we could access the Authorize Endpoint at the following URL 'https://demo.deel.com/oauth2/tokens Since last week, … --- ## [Cannot Complete OAuth - Authorization Code Request as an error occurs while collecting Tokens in Postman](https://stack.deel.com/t/cannot-complete-oauth-authorization-code-request-as-an-error-occurs-while-collecting-tokens-in-postman/424)
**Author:** [@Vineet](https://stack.deel.com/u/Vineet)\ **Replies:** 2\ **Last updated:** [June 23, 2025, 7:18am UTC](https://stack.deel.com/t/cannot-complete-oauth-authorization-code-request-as-an-error-occurs-while-collecting-tokens-in-postman/424 "2025-06-23T07:18:41Z")
Org name: Oahi WFM, previously branded as Tambla WFM \[Partner to DEEL\] Detailed description of the issue and where it occurs: The below procedure was working between 24APR25 - 25MAY25 (Approximate Dates) We use Postm… --- ## [Missing \`hiring\_status\` value option from GET /people](https://stack.deel.com/t/missing-hiring-status-value-option-from-get-people/412)
**Author:** [@b.johnson](https://stack.deel.com/u/b.johnson)\ **Replies:** 3\ **Last updated:** [June 20, 2025, 11:36am UTC](https://stack.deel.com/t/missing-hiring-status-value-option-from-get-people/412 "2025-06-20T11:36:57Z")
Org name: Blue River Tech Detailed description of the issue and where it occurs: The API doc for the GET people endpoint only lists 4 types of hiring\_statuses for use, but I have contractors with statuses other than wh… --- ## [Imputed Income - What Endpoint (if available) should be used to input it? ](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351)
**Author:** [@cameron.fry](https://stack.deel.com/u/cameron.fry)\ **Replies:** 11\ **Last updated:** [June 12, 2025, 2:49pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351 "2025-06-12T14:49:00Z")
We have a client that wants to send Imputed income from their recognition and rewards platform into their Deel platform through an automation leveraging API connections. We have the data for the imputed income and any n… --- ## [Issue Retrieving Bank Account via API – "Contract Not Found" Error](https://stack.deel.com/t/issue-retrieving-bank-account-via-api-contract-not-found-error/387)
**Author:** [@Kombo](https://stack.deel.com/u/Kombo)\ **Replies:** 2\ **Last updated:** [June 9, 2025, 10:11am UTC](https://stack.deel.com/t/issue-retrieving-bank-account-via-api-contract-not-found-error/387 "2025-06-09T10:11:26Z")
Hello, I’m trying to retrieve a bank account based on an employee using the Deel API. However, every time I make the API call, I receive the error message: “Contract not found.” I also noticed that I can’t manually add… --- ## [Update phone number using API](https://stack.deel.com/t/update-phone-number-using-api/79)
**Author:** [@volodymyr.d](https://stack.deel.com/u/volodymyr.d)\ **Replies:** 5\ **Last updated:** [June 9, 2025, 10:01am UTC](https://stack.deel.com/t/update-phone-number-using-api/79 "2025-06-09T10:01:50Z")
hey! going thru the API documentation and trying to figure out if it’s possible to update person’s phone number using API. as I couldn’t find how to do that I’ve started looking into using custom fields. and I found ou… --- ## [Invoice Adjustments endpoint](https://stack.deel.com/t/invoice-adjustments-endpoint/419)
**Author:** [@IronRat](https://stack.deel.com/u/IronRat)\ **Replies:** 6\ **Last updated:** [June 9, 2025, 9:34am UTC](https://stack.deel.com/t/invoice-adjustments-endpoint/419 "2025-06-09T09:34:44Z")
I have created Invoice Adjustments, for some contract, but it didint display in Deel Invoice (bills) screen, but I still can see it in API Endpoint List of Invoice adjustments, how does it works? And How I can create tw… [Next page](https://stack.deel.com/latest.md?page=1)