{"Status":true,"Message":"","Response":{"post":{"postuid":"b6fd6de5-ae38-4144-902c-dfaa4908a039","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"542e5f51-33cf-401f-aebe-4324ebe36fe4","title":"Create or Update a Lead","slug":"reference/create-or-edit-a-lead","html":"\u003Cp\u003ECreates or updates a lead.\u003C/p\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n    \u0026quot;leadId\u0026quot;: 114065807,\r\n    \u0026quot;campaignId\u0026quot;: 23505,\r\n    \u0026quot;ip\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;leadSource\u0026quot;: \u0026quot;All Contacts\u0026quot;,\r\n    \u0026quot;leadSourceId\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;points\u0026quot;: 0,\r\n    \u0026quot;score\u0026quot;: 0,\r\n    \u0026quot;leadStatus\u0026quot;: \u0026quot;Active\u0026quot;,\r\n    \u0026quot;leadOrigin\u0026quot;: \u0026quot;Segment\u0026quot;,\r\n    \u0026quot;leadOriginId\u0026quot;: \u0026quot;21483\u0026quot;,\r\n    \u0026quot;leadOriginName\u0026quot;: \u0026quot;All Contacts\u0026quot;,\r\n    \u0026quot;leadExtendedProperties\u0026quot;: {},\r\n    \u0026quot;segments\u0026quot;: [],\r\n    \u0026quot;leadUID\u0026quot;: \u0026quot;27dbd702a45940d68a7d877394d5418e-114065807\u0026quot;,\r\n    \u0026quot;Description\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;date_created\u0026quot;: \u0026quot;2025-09-26T18:36:09.373\u0026quot;,\r\n    \u0026quot;tenantId\u0026quot;: 4647,\r\n    \u0026quot;dsId\u0026quot;: \u0026quot;27dbd702a45940d68a7d877394d5418e\u0026quot;,\r\n    \u0026quot;salutation\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;firstName\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;lastName\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;donotcontact\u0026quot;: false,\r\n    \u0026quot;maxContactFrequencyInDays\u0026quot;: 0,\r\n    \u0026quot;optOutEmail\u0026quot;: false,\r\n    \u0026quot;optOutSms\u0026quot;: false,\r\n    \u0026quot;optOutPush\u0026quot;: false,\r\n    \u0026quot;optOutPhone\u0026quot;: false,\r\n    \u0026quot;isPushEnabled\u0026quot;: false,\r\n    \u0026quot;isWebPushEnabled\u0026quot;: false,\r\n    \u0026quot;isSmsEnabled\u0026quot;: true,\r\n    \u0026quot;isEmailEnabled\u0026quot;: false,\r\n    \u0026quot;isEmailVerifiedForDelivery\u0026quot;: false,\r\n    \u0026quot;isSMSVerified\u0026quot;: false,\r\n    \u0026quot;fullname\u0026quot;: \u0026quot;\u002B18042916993\u0026quot;,\r\n    \u0026quot;email\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;title\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;status\u0026quot;: \u0026quot;Active\u0026quot;,\r\n    \u0026quot;company\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;numberOfEmployees\u0026quot;: 0,\r\n    \u0026quot;industry\u0026quot;: 0,\r\n    \u0026quot;annualRevenue\u0026quot;: 0,\r\n    \u0026quot;website\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;phone\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;mobilePhone\u0026quot;: \u0026quot;\u002B18042916993\u0026quot;,\r\n    \u0026quot;homePhone\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;timezone\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;avatarPath\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;country\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;city\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;postalCode\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;address\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;geoCode\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;dateDoNotContactUntil\u0026quot;: null,\r\n    \u0026quot;dateFirstSeen\u0026quot;: \u0026quot;1753-01-01T00:00:00\u0026quot;,\r\n    \u0026quot;dateLastSeen\u0026quot;: \u0026quot;1753-01-01T00:00:00\u0026quot;,\r\n    \u0026quot;region\u0026quot;: \u0026quot;\u0026quot;,\r\n    \u0026quot;gender\u0026quot;: 0,\r\n    \u0026quot;dateBirth\u0026quot;: null,\r\n    \u0026quot;age\u0026quot;: 0,\r\n    \u0026quot;extendedProperties\u0026quot;: {},\r\n  }\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eleadid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe numeric identifier for a lead to update. Do not include if this is a create.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Ecampaignid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe campaign id to add the lead to.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Ch2 id=\u0022creating_a_new_lead\u0022\u003ECreating a new lead\u003C/h2\u003E\u003Cp\u003EWhen creating a new lead a JSON object is POSTed to the API endpoint. While the lead object support many properties, creating a new lead is very simple. Creating a new lead requires the campaign id and either an email address or mobile phone number.\u003C/p\u003E\u003Cp\u003EFor example, creating a new lead with just an email address:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n    \u0026quot;campaignId\u0026quot;:22226,\r\n    \u0026quot;email\u0026quot;:\u0026quot;test@example.com\u0026quot;\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EOf course, additional details can be provided as well:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n    \u0026quot;campaignId\u0026quot;:22226,\r\n    \u0026quot;firstName\u0026quot;:\u0026quot;Chris\u0026quot;,\r\n    \u0026quot;lastName\u0026quot;:\u0026quot;Apple\u0026quot;,\r\n    \u0026quot;email\u0026quot;:\u0026quot;test@example.com\u0026quot;,\r\n    \u0026quot;mobilePhone\u0026quot;:\u0026quot;\u002B15553610860\u0026quot;\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003E\u003C/p\u003E","json_meta":{"api_verb":"POST","api_path":"https://us-1.dailystory.com/api/v1/lead/"},"publish_status":0,"post_type":"API","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Create or update a lead by setting leadId for updates. Includes HTTP request example and parameters for leadId and campaignId.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"sort_order":3,"total_views":0,"date_published":"2025-09-26T20:12:02.477","date_updated":"2026-02-17T22:47:25.167","date_created":"2025-09-26T20:09:00.137"}}}