> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thnks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Object Data Dictionary

***

## Object Data Dictionary v1.8

Version 1.8 introduces the new Thnks Request object alongside the existing Thnks object, providing comprehensive workflow automation capabilities.

### Thnks Object Data Dictionary

Below is a table with the default labels, API names and definitions for all fields that come with the AppExchange listing within the Thnks object.

**Object Label**: Thnks
**Object API Name**: thnksdev1\_\_Gift\_\_c

| Field Label            | API Name                                        | Field Type                  | Purpose                                                                                               |
| ---------------------- | ----------------------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------- |
| Account                | thnksdev1\_\_Account\_\_c                       | Lookup(Account)             | Account that Thnks is related with (only associated if a Contact match is made).                      |
| Actual Sender          | thnksdev1\_\_Actual\_Sender\_\_c                | Lookup(User)                | Internal Salesforce User that initiated the sending of the Thnks.                                     |
| Carbon Neutral Cost    | thnksdev1\_\_Carbon\_Neutral\_Cost\_\_c         | Currency(16, 2)             | Cost for carbon-neutral Thnks delivery.                                                               |
| Created By             | CreatedById                                     | Lookup(User)                | Standard Salesforce field displaying what user created the record. Will be the same as Actual Sender. |
| Deal Stage             | thnksdev1\_\_Deal\_Stage\_\_c                   | Text(255)                   | If an Opportunity is matched, this is a stamp of the Opportunity’s Stage at the time of Thnks send.   |
| Delivered              | thnksdev1\_\_Delivered\_\_c                     | Formula (Checkbox)          | Indicates whether the Thnks has been delivered to the recipient.                                      |
| Delivered By           | thnksdev1\_\_DeliveryType\_\_c                  | Picklist                    | Whether Thnks was sent via Email or SMS.                                                              |
| Delivered Date/Time    | thnksdev1\_\_Delivered\_Date\_Time\_\_c         | Date/Time                   | Timestamp of when the Thnks was delivered.                                                            |
| Description            | thnksdev1\_\_Description\_\_c                   | Long Text Area(131072)      | The item description of the Thnks that was sent.                                                      |
| Donated Date/Time      | thnksdev1\_\_Donated\_Date\_Time\_\_c           | Date/Time                   | Timestamp of when the Thnks was donated.                                                              |
| Expired Date/Time      | thnksdev1\_\_Expired\_Date\_Time\_\_c           | Date/Time                   | Timestamp of when the Thnks expired.                                                                  |
| Item Cost              | thnksdev1\_\_Item\_Cost\_\_c                    | Currency(16, 2)             | Base cost of the Thnks that was sent.                                                                 |
| Last Modified By       | LastModifiedById                                | Lookup(User)                | Standard Salesforce field.                                                                            |
| Link                   | thnksdev1\_\_RecipientTransactionLink\_\_c      | URL(255)                    | Link to the Thnks within the Thnks app.                                                               |
| Message                | thnksdev1\_\_Message\_\_c                       | Long Text Area(131072)      | The custom message that was entered when sending the Thnks.                                           |
| Name                   | Name                                            | Text(80)                    | Standard Salesforce field. This is the name of the Thnks being sent.                                  |
| Opened                 | thnksdev1\_\_Opened\_\_c                        | Formula (Checkbox)          | Indicates whether the Thnks has been opened by the recipient.                                         |
| Opened Date/Time       | thnksdev1\_\_Opened\_Date\_Time\_\_c            | Date/Time                   | Timestamp of when the Thnks was opened by the recipient.                                              |
| Opportunity            | thnksdev1\_\_Opportunity\_\_c                   | Lookup(Opportunity)         | Account that Thnks is related with (only associated if a Contact match is made)                       |
| Owner                  | OwnerId                                         | Lookup(User,Group)          | Standard Salesforce field.                                                                            |
| Recipient Contact      | thnksdev1\_\_RecipientContactId\_\_c            | Lookup(Contact)             | Contact that Thnks is related with.                                                                   |
| Recipient Email        | thnksdev1\_\_Recipient\_Email\_\_c              | Email                       | The actual email that the Thnks was sent to.                                                          |
| Recipient Lead         | thnksdev1\_\_RecipientLeadId\_\_c               | Lookup(Lead)                | Lead that Thnks is related with.                                                                      |
| Recipient Phone Number | thnksdev1\_\_Recipient\_Phone\_Number\_\_c      | Phone                       | The actual phone number that the Thnks was sent to.                                                   |
| Redeemed               | thnksdev1\_\_Redeemed\_\_c                      | Formula (Checkbox)          | Indicates whether the Thnks has been redeemed by the recipient.                                       |
| Redeemed Date/Time     | thnksdev1\_\_Redeemed\_Date\_Time\_\_c          | Date/Time                   | Timestamp of when the Thnks was redeemed.                                                             |
| Refunded Date/Time     | thnksdev1\_\_Refunded\_Date\_Time\_\_c          | Date/Time                   | Timestamp of when the Thnks was refunded.                                                             |
| Sender                 | thnksdev1\_\_SenderId\_\_c                      | Lookup(User)                | Internal Salesforce User that initiated the sending of the Thnks.                                     |
| Sender Email           | thnksdev1\_\_Sender\_Email\_\_c                 | Email                       | The actual email of the person sending the Thnks.                                                     |
| Shipping Cost          | thnksdev1\_\_Shipping\_Cost\_\_c                | Currency(16, 2)             | Shipping cost of the Thnks (physical items only).                                                     |
| Status                 | thnksdev1\_\_RecipientTransactionStatus\_\_c    | Picklist                    | Picklist field tracking the current status of the Thnks (controlled by Thnks app)                     |
| Thnks Item Id          | thnksdev1\_\_GiftId\_\_c                        | Number(18, 0)               | Unique item ID of the Thnks.                                                                          |
| Thnks Sent At          | thnksdev1\_\_RecipientTransactionCreatedAt\_\_c | Date/Time                   | Timestamp of when the Thnks was sent.                                                                 |
| Total Price            | thnksdev1\_\_RecipientTransactionPrice\_\_c     | Currency(16, 2)             | Total cost of the Thnks send.                                                                         |
| Transaction Fee        | thnksdev1\_\_Transaction\_Fee\_\_c              | Currency(16, 2)             | Transaction fee of the Thnks send.                                                                    |
| Transaction Id         | thnksdev1\_\_RecipientTransactionId\_\_c        | Number(18, 0) (External ID) | Unique transaction ID for Thnks send.                                                                 |
| Undelivered Date/Time  | thnksdev1\_\_Undelivered\_Date\_Time\_\_c       | Date/Time                   | Timestamp of when the Thnks was undelivered.                                                          |

### Thnks Request Object Data Dictionary

**New in v1.8**, the Thnks Request object enables workflow automation and approval processes for Thnks sending.

**Object Label**: Thnks Request
**Object API Name**: Thnks\_\_Request\_\_c

| Field Label                 | API Name                                     | Field Type          | Purpose                                                                                |
| --------------------------- | -------------------------------------------- | ------------------- | -------------------------------------------------------------------------------------- |
| Account                     | Thnks\_\_Account\_\_c                        | Lookup(Account)     | Account that Thnks Request is related with.                                            |
| Auto-Approved               | Thnks\_\_Auto\_Approved\_\_c                 | Checkbox            | Indicates if the request should be automatically approved without manual intervention. |
| Created By                  | CreatedById                                  | Lookup(User)        | Standard Salesforce field displaying what user created the record.                     |
| Credit Card Id              | Thnks\_\_Credit\_Card\_Id\_\_c               | Text(255)           | Reference to the credit card used for payment processing.                              |
| Gift Category Id            | Thnks\_\_Gift\_Category\_Id\_\_c             | Text(255)           | Category identifier for the selected gift type.                                        |
| Gift Id                     | Thnks\_\_Gift\_Id\_\_c                       | Text(255)           | Unique identifier for the specific gift selected.                                      |
| Gift Item Description       | Thnks\_\_Gift\_Item\_Description\_\_c        | Text(255)           | Description of the gift item being sent.                                               |
| Include Amazon Shipping     | Thnks\_\_Include\_Amazon\_Shipping\_\_c      | Checkbox            | Indicates if Amazon shipping should be included for physical gifts.                    |
| Include Carbon Neutral Cost | Thnks\_\_Include\_Carbon\_Neutral\_Cost\_\_c | Checkbox            | Indicates if carbon neutral shipping cost should be included.                          |
| Item in Thnks               | Thnks\_\_Item\_in\_Thnks\_\_c                | URL(255)            | Direct link to the gift item in the Thnks catalog.                                     |
| Last Modified By            | LastModifiedById                             | Lookup(User)        | Standard Salesforce field for tracking last modification.                              |
| Opportunity                 | Thnks\_\_Opportunity\_\_c                    | Lookup(Opportunity) | Opportunity that Thnks Request is related with.                                        |
| Owner                       | OwnerId                                      | Lookup(User,Group)  | Standard Salesforce field for record ownership.                                        |
| Payment Method              | Thnks\_\_Payment\_Method\_\_c                | Text(255)           | Payment method selected for the Thnks request.                                         |
| Request Status              | Thnks\_\_Request\_Status\_\_c                | Picklist            | Current status of the Thnks request (Pending, Approved, Rejected, Sent).               |
| Root Gift Id                | Thnks\_\_Root\_Gift\_Id\_\_c                 | Text(255)           | Root identifier for gift categorization.                                               |
| Send Type                   | Send\_Type\_\_c                              | Text Area(255)      | Type of send method (email, SMS, etc.).                                                |
| Third Party Gift Id         | Thnks\_\_Third\_Party\_Gift\_Id\_\_c         | Text(255)           | Third-party vendor gift identifier.                                                    |
| Third Party Vendor          | Thnks\_\_Third\_Party\_Vendor\_\_c           | Text(255)           | Third-party vendor name for gift fulfillment.                                          |
| Thnks Error Log             | Thnks\_\_Thnks\_Error\_Log\_\_c              | Text(255)           | Error log for troubleshooting failed requests.                                         |
| Thnks Request Number        | Name                                         | Auto Number         | Auto-generated unique number for the Thnks request.                                    |
| Use User Balance            | Thnks\_\_Use\_User\_Balance\_\_c             | Checkbox            | Indicates if user's account balance should be used for payment.                        |

### Field Usage Notes

**Status Field Values:**

* **Pending**: Request created but not yet processed
* **Approved**: Request approved and ready for sending
* **Rejected**: Request rejected by approver
* **Sent**: Thnks successfully sent and Thnks record created

**Auto-Approved Field:**

* When checked, requests bypass manual approval process
* Controlled by "Default New Requests to Auto-Approve" setting in Manage Thnks Settings
* Can be manually unchecked on individual records if approval is needed

**Gift ID Fields:**

* Multiple gift ID fields support different gift catalog structures
* Root Gift Id provides categorization
* Third Party fields enable vendor-specific gift fulfillment
