# Imputed Income - What Endpoint (if available) should be used to input it? 

**URL:** <https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351>\
**Category:** Q&A\
**Created:** [January 22, 2025, 5:03pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351 "2025-01-22T17:03:29Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [January 22, 2025, 5:03pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/1 "2025-01-22T17:03:29Z")

</div>

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 necessary accompanying user data, but are unsure if Deel’s Global Payroll API or Off-Cycle Payments API would be the right destination for the imputed income inputs.

Is there an endpoint on the current API that would work?

If not, what is the recommendation to the client on how we could most easily get this data to them in a method with the least amount of human/manual intervention.

Thank you!!

---

<div class="post-metadata">

**Author:** ![Gabriela\_Deel](https://avatars.discourse-cdn.com/v4/letter/g/ecae2f/32.png) [@Gabriela\_Deel](https://stack.deel.com/u/Gabriela_Deel)\
**Post date:** [January 22, 2025, 6:03pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/2 "2025-01-22T18:03:50Z")

</div>

Hello @cameron.fry,

This extra income can indeed be added via API, but on what endpoint to use it depends on what type of worker your client is referring to.

For Contractors: [Create off cycle payment](https://developer.deel.com/reference/createoffcyclepayment)

For other types (EOR or GP): [Create adjustment](https://developer.deel.com/reference/createadjustment) and [Get categories](https://developer.deel.com/reference/getcategories) to find the right category for the extra income

Kindly let us know in case you have further doubts 😀

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [January 22, 2025, 6:19pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/3 "2025-01-22T18:19:39Z")

</div>

Thank you so much! I’ll be sure to reach out when we have more details from the client, but this is a really great start!

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [May 9, 2025, 3:18pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/4 "2025-05-09T15:18:24Z")

</div>

Ok, I’m back!

The client is concerned about the tax management for this imputed income automation.

They want some clarification on making sure the employees are not getting paid the amount we send to Deel, that they aren’t paying the taxes on that amount, and that Deel is automatically covering the taxes for those employees.

They want guidance and clarification on what steps need to be taken when setting up the codes and categories on their Deel platform to make sure this happens.

This is for non-contractors, so we’re using the Create Adjustment endpoint.

For more context, the client is using Awardco to award points to employees, and those employees are spending the points on he Awardco platform. This is considered taxable “imputed income”, and should not added to their paychecks when sent to Deel.

E.g. Employee receives 100 points in Awardco, and spends it on a $100 gift card, the client needs to track that $100 as imputed income and tax the employee based on that extra $100 ‘earned’, but in this particular case the client is covering the taxes for that employee.

If there are support docs anywhere that walk through this, I’d be happy to read through them.

---

<div class="post-metadata">

**Author:** ![Gabriela\_Deel](https://avatars.discourse-cdn.com/v4/letter/g/ecae2f/32.png) [@Gabriela\_Deel](https://stack.deel.com/u/Gabriela_Deel)\
**Post date:** [May 21, 2025, 3:21pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/5 "2025-05-21T15:21:12Z")

</div>

Hello @cameron.fry,

If you don’t want for the worker to receive that amount and only store this information in Deel, I recommend using custom fields for that. The Adjustment will indeed give this amount to the worker and add this value to the client billing.

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [May 21, 2025, 9:06pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/6 "2025-05-21T21:06:12Z")

</div>

Hi Gabriela, Could you give some additional context, examples, or even screenshots that would help demonstrate or indicate how this could be accomplished?

---

<div class="post-metadata">

**Author:** ![Gabriela\_Deel](https://avatars.discourse-cdn.com/v4/letter/g/ecae2f/32.png) [@Gabriela\_Deel](https://stack.deel.com/u/Gabriela_Deel)\
**Post date:** [May 22, 2025, 10:56am UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/7 "2025-05-22T10:56:29Z")

</div>

For sure!

You can add a Custom Field either on the **worker profile** level or on the **contract level**.

On the UI, please go to **Organizations settings → Custom fields** _(image attached)_

 ![Custom Fields for Payments](https://canada1.discourse-cdn.com/flex003/uploads/deel_developer/original/1X/8c12a5a02bd42ecdda5d43be22a8f9ef6668fc47.png)

After the custom field is created with the needed configuration, you can rely on Deel APIs to update this information:

- Use this API, if the custom field is stored on the **worker profile**
- Use [this API](https://developer.deel.com/reference/upsertcustomfieldvaluefromcontracts), if the custom field is stored on the **contract**

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [June 4, 2025, 7:11pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/8 "2025-06-04T19:11:01Z")

</div>

Thanks for pointing this out, Gabriela!

I can’t say I’m very familiar with the platform yet, so I have no clue how some of these features would work, but I’m also not seeing that custom fields option anywhere in our developer sandbox…

Ideally, I would love to work with someone, maybe get a series of screenshots or get on a call, to discuss how to create a custom field for employees for this imputed income process and how to ensure that the inputs we make with the “Update Custom Field” endpoint would result in the desired outcome of taxing on, but not awarding, the gross amounts earned/spent in Awardco.

Thank you!

---

<div class="post-metadata">

**Author:** ![Gabriela\_Deel](https://avatars.discourse-cdn.com/v4/letter/g/ecae2f/32.png) [@Gabriela\_Deel](https://stack.deel.com/u/Gabriela_Deel)\
**Post date:** [June 9, 2025, 8:18am UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/9 "2025-06-09T08:18:20Z")

</div>

Hello @cameron.fry

Not to worry, I am sure you will get familiar with the platform eventually. For getting access to this screen, please log in to [https://app.demo.deel.com/](https://app.demo.deel.com/) with your API Sandbox credentials.

With this, you should have access to the UI of the Demo account linked to your sandbox environment.

Let me know in case you have any trouble.

All the best,  
Gabriela

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [June 11, 2025, 7:45pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/10 "2025-06-11T19:45:08Z")

</div>

Ok, I was able to create a custom field, named it imputed income, and chose all of the options during setup that I thought were relevant to what we’ll be doing, but I’m still lost on how updating this field for an employee will allow clients to attribute the taxes to the employees from the off-platform earnings/spendings they had on the Awardco platform without giving them that gross amount.

Thank you,  
Cameron

---

<div class="post-metadata">

**Author:** ![Gabriela\_Deel](https://avatars.discourse-cdn.com/v4/letter/g/ecae2f/32.png) [@Gabriela\_Deel](https://stack.deel.com/u/Gabriela_Deel)\
**Post date:** [June 12, 2025, 9:31am UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/11 "2025-06-12T09:31:19Z")

</div>

Hello Cameron,

Given the current structure, either the client submit this as an Adjustment/Expense/Off-cycle payment, that will generate a billing for the Reward amount and will be tax compliant. Or you can submit this value in a custom field only for control, but Deel will not collect taxes on this amount.

We don’t offer a programmatical way to add Rewards delivered outside of the platform into the tax calculations inside of the platform.

---

<div class="post-metadata">

**Author:** ![cameron.fry](https://avatars.discourse-cdn.com/v4/letter/c/ecc23a/32.png) [@cameron.fry](https://stack.deel.com/u/cameron.fry)\
**Post date:** [June 12, 2025, 2:49pm UTC](https://stack.deel.com/t/imputed-income-what-endpoint-if-available-should-be-used-to-input-it/351/12 "2025-06-12T14:49:00Z")

</div>

Ok, if there’s no way to _programatically_ add that data via API, how would a client go about doing that manually?

I would have to imagine that the Deel Payroll has some way for clients to track things like cash or gift cards being given to employees, and ensuring that taxes are attributed with those off-payroll earnings.

Or is the alternative to tell Deel Payroll clients to avoid giving cash, gift cards, and other non-paycheck gifts, or to only provide those gifts in the form of off-cycle payments and adjustments?

thank you
