--- title: API Record Details description: Master Spinify's API Record Details! Learn how to effectively manage and utilize data attributes for events through API integration. --- [Skip to content](https://knowledge.spinify.com/help/api-record-details#main-content) English Show submenu for translations [Create Ticket](https://knowledge.spinify.com/help/kb-tickets/new?hsLang=en) [Customer Portal](https://knowledge.spinify.com/tickets?hsLang=en) - [Home](https://knowledge.spinify.com/) - [Customer Portal](https://knowledge.spinify.com/tickets?offset=0) - [Academy](https://academy.spinify.com/trainings) - [YouTube](https://www.youtube.com/channel/UCr89cR8jfrU7LbTBFSu2iPQ) - [Success Stories](https://spinify.com/customer-stories/) - [Blog](https://spinify.com/blog/) Open main navigation Close main navigation - [Home](https://knowledge.spinify.com/) - [Customer Portal](https://knowledge.spinify.com/tickets?offset=0) - [Academy](https://academy.spinify.com/trainings) - [YouTube](https://www.youtube.com/channel/UCr89cR8jfrU7LbTBFSu2iPQ) - [Success Stories](https://spinify.com/customer-stories/) - [Blog](https://spinify.com/blog/) - English Show submenu for translations - [Create Ticket](https://knowledge.spinify.com/help/kb-tickets/new) - [Customer Portal](https://knowledge.spinify.com/tickets) - [Spinify Academy](https://academy.spinify.com/trainings) [Spinify Academy](https://academy.spinify.com/trainings) How can we help you? - There are no suggestions because the search field is empty. 1. [Spinify Knowledge](https://knowledge.spinify.com/help?hsLang=en) 2. [Integrations](https://knowledge.spinify.com/help/integrations?hsLang=en) 3. [Spinify API](https://knowledge.spinify.com/help/integrations?hsLang=en#spinify-api) # API Record Details The below contains the information to include in the "Data" object for a request to the Events endpoint. Connecting Records to Spinify Users *Note: Owner needs to be the **user’s email address**. If the user doesn’t exist in Spinify and doesn’t exactly match the email will still be accepted but won’t be applied to a competition, gamification, etc.* ### 🤝Deal   | **Name** | **Type** | **Is Required** | | --- | --- | --- | | ObjectID | string | ✅ | | ExternalOrgId | string | ✅ | | Name | string | ✅ | | CloseDate | datetime | ✅ | | Owner | string | ✅ | | Type | string | ✅ | | Amount | number | ✅ | | IsClosed | boolean | ✅ | | IsWon | boolean | ✅ | | IsDeleted | boolean | ✅ | | SalesStage | string | ✅ | | LastContacted | datetime |   | | LastUpdated | datetime | ✅ | | Created | datetime | ✅ | | Probability | number |   | | ForecastCategory | string |   | | NextStep | string |   | | ExpectedRevenue | number |   | | LeadSource | string |   | | IsPrivate | boolean |   | | RecordType | string |   | #### Example Deal Request: ``` [{  "Type": "Deal",  "RecordUrl": "https://example.com/006R000000TdGmrIAF",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "IsDeleted": false,    "CloseDate": "2017-10-12T14:56:35.000Z",    "Type": "Existing Business",    "NextStep": null,    "LastContacted": null,    "Probability": 100,    "IsClosed": true,    "Name": "Spinify Monthly Renewal",    "LeadSource": null,    "ExpectedRevenue": null,    "IsWon": true,    "Owner": "owner.email@spinify.com",    "RecordType": "Test",    "IsPrivate": null,    "ForecastCategory": "Closed",    "Amount": 500.00,    "SalesStage": "Closed Won",    "LastUpdated": "2017-10-12T14:56:35.000Z",    "Created": "2017-10-12T14:56:22.000Z",    "ExternalOrgId": "local",    "ObjectId": "006R000000TdGmrIAF"  }}] ``` ### 📞Call ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-40-1317-AM.png) #### Example Call Request: ``` [{  "Type": "Call",  "RecordUrl": "https://example.com/00TR000000VdjXfMAJ",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "Name": "Call",    "Type": "Call",    "RelatedDeal": "006R000000TdGmrIAF",    "LastUpdated": "2017-10-12T14:56:46.000Z",    "RecordType": null,    "IsClosed": true,    "Owner": "owner.email@spinify.com",    "Status": "Completed",    "IsDeleted": false,    "ActivityDate": "2017-10-12",    "ExternalOrgId": "local",    "ObjectId": "00TR000000VdjXfMAJ"  }}] ``` ### 📧Email ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-41-2469-AM.png) #### Example Email Request ``` [{  "Type": "Email",  "RecordUrl": "https://example.com/00TR000000VdjXpMAJ",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "Owner": "owner.email@spinify.com",    "Type": "Email",    "RecordType": null,    "Name": "Email: Your Monthly Renewal",    "RelatedDeal": "006R000000TdGmrIAF",    "LastUpdated": "2017-10-12T14:58:21.000Z",    "IsDeleted": false,    "IsClosed": true,    "Status": "Completed",    "ActivityDate": "2017-10-12",    "ExternalOrgId": "local",    "ObjectId": "00TR000000VdjXpMAJ"  }}] ``` ### 🗓️Meeting ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-39-5662-AM.png) #### Example Meeting Request ``` {  "Type": "Meeting",  "RecordUrl": "https://example.com/00TR000000VdjXkMAJ",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "RecordType": null,    "RelatedDeal": "006R000000TdGmrIAF",    "IsClosed": false,    "LastUpdated": "2017-10-12T14:57:48.000Z",    "Name": "Meeting: 10/12/2017",    "Status": "Open",    "IsDeleted": false,    "ActivityDate": "2017-10-12",    "Type": "Task",    "Owner": "owner.email@spinify.com",    "ExternalOrgId": "local",    "ObjectId": "00TR000000VdjXkMAJ"  }} ``` ### 🔌Lead ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-42-9165-AM.png) #### Example Lead Request ``` [{  "Type": "Lead",  "RecordUrl": "https://example.com/00QR000000G4oNIMAZ",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "Name": "John Johnson",    "Owner": "owner.email@spinify.com",    "IsQualified": false,    "Company": "Spinify",    "QualifiedDate": null,    "CreatedDate": "2017-08-29T12:54:20.000Z",    "IsDeleted": false,    "RecordType": null,    "LastUpdated": "2017-10-12T15:08:15.000Z",    "Status": "New",    "ExternalOrgId": "local",    "ObjectId": "00QR000000G4oNIMAZ"  }}] ``` ### 👤Account ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-41-7657-AM.png) #### Example Account Request ``` [{  "Type": "Account",  "RecordUrl": "https://example.com/001R000001GIhVNIA1",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "RecordType": null,    "Industry": "Technology",    "IsActive": null,    "Owner": "owner.email@spinify.com",    "Status": null,    "ActivationDate": null,    "CreatedDate": "2017-07-07T22:45:57.000Z",    "LastUpdated": "2017-10-12T15:09:40.000Z",    "Name": "Spinify",    "Type": "Analyst",    "IsDeleted": false,    "ExternalOrgId": "local",    "ObjectId": "001R000001GIhVNIA1"  }}] ``` ### 💸Trailing Revenue ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-40-6938-AM.png) #### Example Trailing Revenue Request ``` [{  "Type": "TrailingRevenue",  "RecordUrl": "https://example.com/001R000001GIhVNIA1",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "Name": "Sale Name"    "StartDate": "2017-07-07T22:45:57.000Z",    "EndDate": "2017-07-07T22:45:57.000Z",    "Owner": "owner.email@spinify.com",    "Revenue": 150,    "Account": "Abc Corp",    "LastUpdated": "2017-10-12T15:09:40.000Z",    "RecordType": null,    "IsDeleted": false    "ExternalOrgId": "local",    "ObjectId": "001R000001GIhVNIA1"  }}] ``` ### 💼Case ![image.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/image-May-02-2024-03-58-42-2832-AM.png) #### Example Case Request ``` [{  "Type": "Case",  "RecordUrl": "https://example.com/500R0000008E04QIAS",  "ExternalOrgId": "local",  "EventID": "UniquelyGeneratedValue",  "Data": {    "Milestones": [      {        "CompletionDate": null,        "IsCompleted": false,        "IsViolated": false,        "StartDate": "2017-10-12T15:15:05.000Z",        "Type": "First Response",        "TargetDate": "2017-10-12T15:18:05.000Z"      }    ],    "Origin": "Web",    "ContactEmail": null,    "CaseNumber": "00001633",    "IsClosed": false,    "Priority": "High",    "Reason": "New problem",    "WebEmail": null,    "ContactPhone": null,    "RecordType": null,    "WebName": null,    "WebCompany": null,    "Subject": "API Isn't Working As Expected",    "IsClosedOnCreate": null,    "Type": "Problem",    "LastUpdated": "2017-10-12T15:15:05.000Z",    "WebPhone": null,    "Status": "New",    "IsEscalated": false,    "Name": "00001633",    "Owner": "owner.email@spinify.com",    "ContactMobile": null,    "CreatedDate": "2017-10-12T15:15:05.000Z",    "ClosedDate": null,    "ExternalOrgId": "local",    "ObjectId": "500R0000008E04QIAS"  }}] ``` ### 🏡PropertyListing ![PropertyListing-fields.png](https://knowledge.spinify.com/hubfs/Knowledge%20Base%20Import/PropertyListing-fields.png) #### Example PropertyListing Request ``` [{ "Type": "PropertyListing", "ExternalOrgId": "local", "EventID": "UniquelyGeneratedValue", "Data": {  "ObjectId": "17358057",  "Classification": "residential",  "PriceFrom": 2000000,  "CommercialSaleType": "sale",  "Status": "conditional",  "Name": "10 Main Street, Phillip ACT, Australia",  "Street": "10 Main Street",  "City": "PHILLIP",  "State": "ACT"  "Country": "Australia",  "Type": "House",  "Bedrooms": 3,  "Bathrooms": 2,  "Toilets": 2,  "Garages": 1,  "Carports": 0,  "Owner": "owner.email@spinify.com",  "ImageUpdatedAt": "2017-06-16T02:07:36Z",  "ListingAt": "2017-06-15T16:00:00Z",  "UpdatedAt": "2017-06-16T02:11:36Z",  "LastUpdated": "2017-06-16T02:11:36Z",      "CreatedAt": "2017-06-16T02:07:36Z",  "SaleDetailsPrice": 2000000,  "Image": "https://example.com/10-main-street.jpg" }}] ``` *Further details on how to send an events request can be found in[these help articles](https://knowledge.spinify.com/integrations?hsLang=en#spinify-api).* - [Discover Spinify](https://knowledge.spinify.com/help/discover-spinify?hsLang=en) - [Quick Set Up](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#main-content) - [Competitions & Leaderboards](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#competitions-leaderboards) - [Users](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#users) - [Achievements](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#achievements) - [TV & Displays](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#tv-displays) - [Onboarding](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#onboarding) - [Single Sign On](https://knowledge.spinify.com/help/quick-set-up?hsLang=en#single-sign-on) - [Integrations](https://knowledge.spinify.com/help/integrations?hsLang=en#main-content) - [Agentbox](https://knowledge.spinify.com/help/integrations?hsLang=en#agentbox) - [MRI Box and Dice](https://knowledge.spinify.com/help/integrations?hsLang=en#mri-box-and-dice) - [Bullhorn](https://knowledge.spinify.com/help/integrations?hsLang=en#bullhorn) - [Zendesk](https://knowledge.spinify.com/help/integrations?hsLang=en#zendesk) - [PowerBI](https://knowledge.spinify.com/help/integrations?hsLang=en#powerbi) - [CSV Upload](https://knowledge.spinify.com/help/integrations?hsLang=en#csv-upload) - [HubSpot](https://knowledge.spinify.com/help/integrations?hsLang=en#hubspot) - [Google Sheets](https://knowledge.spinify.com/help/integrations?hsLang=en#google-sheets) - [Google Slides or Google Calendar](https://knowledge.spinify.com/help/integrations?hsLang=en#google-slides-or-google-calendar) - [Spinify API](https://knowledge.spinify.com/help/integrations?hsLang=en#spinify-api) - [Salesforce Reports](https://knowledge.spinify.com/help/integrations?hsLang=en#salesforce-reports) - [Microsoft Excel](https://knowledge.spinify.com/help/integrations?hsLang=en#microsoft-excel) - [Pipedrive](https://knowledge.spinify.com/help/integrations?hsLang=en#pipedrive) - [Salesforce Trailhead](https://knowledge.spinify.com/help/integrations?hsLang=en#salesforce-trailhead) - [Tableau](https://knowledge.spinify.com/help/integrations?hsLang=en#tableau) - [LockedOn](https://knowledge.spinify.com/help/integrations?hsLang=en#lockedon) - [Microsoft Teams](https://knowledge.spinify.com/help/integrations?hsLang=en#microsoft-teams) - [SQL](https://knowledge.spinify.com/help/integrations?hsLang=en#sql) - [Slack](https://knowledge.spinify.com/help/integrations?hsLang=en#slack) - [Microsoft Dynamics](https://knowledge.spinify.com/help/integrations?hsLang=en#microsoft-dynamics) - [Outreach](https://knowledge.spinify.com/help/integrations?hsLang=en#outreach) - [Rex Software](https://knowledge.spinify.com/help/integrations?hsLang=en#rex-software) - [JobAdder](https://knowledge.spinify.com/help/integrations?hsLang=en#jobadder) - [Salesforce](https://knowledge.spinify.com/help/integrations?hsLang=en#salesforce) - [Follow Up Boss](https://knowledge.spinify.com/help/integrations?hsLang=en#follow-up-boss) - [Zapier](https://knowledge.spinify.com/help/integrations?hsLang=en#zapier) - [CloudCall](https://knowledge.spinify.com/help/integrations?hsLang=en#cloudcall) - [Freshdesk](https://knowledge.spinify.com/help/integrations?hsLang=en#freshdesk) - [MRI Vault CRM](https://knowledge.spinify.com/help/integrations?hsLang=en#mri-vault-crm) - [Webhooks](https://knowledge.spinify.com/help/integrations?hsLang=en#webhooks) - [FTP](https://knowledge.spinify.com/help/integrations?hsLang=en#ftp) - [GetAccept](https://knowledge.spinify.com/help/integrations?hsLang=en#getaccept) - [Close CRM](https://knowledge.spinify.com/help/integrations?hsLang=en#close-crm) - [HighLevel](https://knowledge.spinify.com/help/integrations?hsLang=en#highlevel) - [Aircall](https://knowledge.spinify.com/help/integrations?hsLang=en#aircall) - [Kixie](https://knowledge.spinify.com/help/integrations?hsLang=en#kixie) - [LeadDesk](https://knowledge.spinify.com/help/integrations?hsLang=en#leaddesk) - [Zoho](https://knowledge.spinify.com/help/integrations?hsLang=en#zoho) - [Incentives](https://knowledge.spinify.com/help/incentives?hsLang=en#main-content) - [Reward Store](https://knowledge.spinify.com/help/incentives?hsLang=en#reward-store) - [Points, Badges & Tiers](https://knowledge.spinify.com/help/incentives?hsLang=en#points-badges-tiers) - [Prize Wheels](https://knowledge.spinify.com/help/incentives?hsLang=en#prize-wheels) - [FAQs](https://knowledge.spinify.com/help/faqs?hsLang=en#main-content) - [Competitions](https://knowledge.spinify.com/help/faqs?hsLang=en#competitions) - [Account](https://knowledge.spinify.com/help/faqs?hsLang=en#account) - [TV & Channels](https://knowledge.spinify.com/help/faqs?hsLang=en#tv-channels) - [Spinify](https://knowledge.spinify.com/help/faqs?hsLang=en#spinify) - [Troubleshooting](https://knowledge.spinify.com/help/faqs?hsLang=en#troubleshooting) - [Sidekick](https://knowledge.spinify.com/help/faqs?hsLang=en#sidekick) - [Achievement](https://knowledge.spinify.com/help/faqs?hsLang=en#achievement) - [Manager Toolkit](https://knowledge.spinify.com/help/manager-toolkit?hsLang=en#main-content) - [AI Coaching Agent](https://knowledge.spinify.com/help/manager-toolkit?hsLang=en#ai-coaching-agent) - [Analytics](https://knowledge.spinify.com/help/manager-toolkit?hsLang=en#analytics) - [Messages & Announcements](https://knowledge.spinify.com/help/manager-toolkit?hsLang=en#messages-announcements) - [Coaching Tools](https://knowledge.spinify.com/help/manager-toolkit?hsLang=en#coaching-tools) - [Administration & Accounts](https://knowledge.spinify.com/help/administration-accounts?hsLang=en#main-content) - [Billing](https://knowledge.spinify.com/help/administration-accounts?hsLang=en#billing) - [Privacy & Terms](https://knowledge.spinify.com/help/administration-accounts?hsLang=en#privacy-terms) - [Players Zone](https://knowledge.spinify.com/help/players-zone?hsLang=en) - [Apps & Extensions](https://knowledge.spinify.com/help/apps-extensions?hsLang=en#main-content) - [Chrome Extension](https://knowledge.spinify.com/help/apps-extensions?hsLang=en#chrome-extension) - [Mobile App](https://knowledge.spinify.com/help/apps-extensions?hsLang=en#mobile-app) - [Spinify MCP](https://knowledge.spinify.com/help/apps-extensions?hsLang=en#spinify-mcp) [![download (2)](https://knowledge.spinify.com/hs-fs/hubfs/download%20(2).png?width=150&height=150&name=download%20(2).png "download (2)")](https://Spinify.com) #1 Ranked Sales Gamification Software [mailto:email@email.com](mailto:email@email.com) Copyright © 2024, Spinify