{"Status":true,"Message":"","Response":{"post":{"postuid":"94edff2c-bfca-4167-b580-dfc1bf4ae8ec","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"542e5f51-33cf-401f-aebe-4324ebe36fe4","title":"Create or Update a Contact","slug":"reference/create-or-edit-a-contact-1","html":"\u003Cp\u003ECreates or updates a contact. A new contact only requires either a valid email address or valid mobile phone number. All other fields are optional.\u003C/p\u003E\u003Cp\u003ESee also the \u003Ca href=\u0022/reference/find-or-create-a-contact\u0022\u003E\u003C/a\u003E\u003Ca href=\u0022/reference/find-or-create-a-contact\u0022\u003EFind or Create a Contact\u003C/a\u003E API.\u003C/p\u003E\u003Ch2 id=\u0022updating_custom_fieldsa_hrefhttpsdevdailystorycomreferencecreateoreditacontact1updatingcustomfieldsa\u0022\u003EUpdating custom fields\u003Ca href=\u0022https://dev.dailystory.com/reference/create-or-edit-a-contact-1#updating-custom-fields\u0022\u003E\u003C/a\u003E\u003C/h2\u003E\u003Cp\u003EDailyStory supports custom fields to allow you to store virtually any data with a contact.\u003C/p\u003E\u003Ccite class=\u0022recommended\u0022\u003E\u003Cspan class=\u0022title\u0022\u003ERecommended\u003C/span\u003E\u003Cp\u003EWhile custom fields comes with their own benefits you can add/remove data using API even if you haven\u0027t created the custom field.\u003C/p\u003E\u003C/cite\u003E\u003Cp\u003ETo update a contact\u0027s custom fields, include the custom field data in the JSON body of your POST:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;email\u0026quot;:\u0026quot;example@example.com\u0026quot;,\r\n  \u0026quot;extendedProperties\u0026quot;:{\r\n    \u0026quot;some_custom_field\u0026quot;:\u0026quot;hello world\u0026quot;\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EWhile not required, we recommend custom field key is lower case, contain no spaces, and are limited to alphanumeric characters. This ensures that if the custom field were used for API access, such as personalization, the customer field could be accessed. For example,\u0026nbsp;\u003Ccode\u003E{{profile.some_custom_field}}\u003C/code\u003E.\u0026nbsp;\u0026nbsp;\u003C/p\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan class=\u0022httpstatus\u0022\u003E\u003Cspan class=\u0022solid-circle success\u0022\u003E\u003C/span\u003E200\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;Status\u0026quot;: true,\r\n  \u0026quot;Message\u0026quot;: \u0026quot;\u0026quot;,\r\n  \u0026quot;Response\u0026quot;: {\r\n    \u0026quot;contact\u0026quot;: {\r\n      \u0026quot;tenantId\u0026quot;: 112,\r\n      \u0026quot;dsId\u0026quot;: \u0026quot;43aaf5af35f866b1edba7\u0026quot;,\r\n      \u0026quot;salutation\u0026quot;: \u0026quot;\u0026quot;,\r\n      \u0026quot;firstName\u0026quot;: \u0026quot;Rob\u0026quot;,\r\n      \u0026quot;lastName\u0026quot;: \u0026quot;Howard\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;: true,\r\n      \u0026quot;isSmsEnabled\u0026quot;: true,\r\n      \u0026quot;isEmailEnabled\u0026quot;: true,\r\n      \u0026quot;isEmailVerifiedForDelivery\u0026quot;: true,\r\n      \u0026quot;isSMSVerified\u0026quot;: false,\r\n      \u0026quot;fullname\u0026quot;: \u0026quot;Rob Howard\u0026quot;,\r\n      \u0026quot;email\u0026quot;: \u0026quot;rob@example.com\u0026quot;,\r\n      \u0026quot;title\u0026quot;: \u0026quot;Founder, CEO\u0026quot;,\r\n      \u0026quot;status\u0026quot;: \u0026quot;Active\u0026quot;,\r\n      \u0026quot;company\u0026quot;: \u0026quot;https://dailystory.com\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;\u002B15557140059\u0026quot;,\r\n      \u0026quot;mobilePhone\u0026quot;: \u0026quot;\u002B15557140059\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;United States\u0026quot;,\r\n      \u0026quot;city\u0026quot;: \u0026quot;Dallas\u0026quot;,\r\n      \u0026quot;postalCode\u0026quot;: \u0026quot;75270\u0026quot;,\r\n      \u0026quot;address\u0026quot;: \u0026quot;\u0026quot;,\r\n      \u0026quot;geoCode\u0026quot;: \u0026quot;33.8731,-93.8607\u0026quot;,\r\n      \u0026quot;dateFirstSeen\u0026quot;: \u0026quot;2021-01-16T19:24:03.283\u0026quot;,\r\n      \u0026quot;dateLastSeen\u0026quot;: \u0026quot;2025-09-23T20:50:49.373\u0026quot;,\r\n      \u0026quot;region\u0026quot;: \u0026quot;Texas\u0026quot;,\r\n      \u0026quot;gender\u0026quot;: 0,\r\n      \u0026quot;age\u0026quot;: 0,\r\n      \u0026quot;extendedProperties\u0026quot;: {\r\n        \u0026quot;stripe_customer_id\u0026quot;: \u0026quot;cus_DRvE6c5V9jp\u0026quot;,\r\n        \u0026quot;class_of_license\u0026quot;: \u0026quot;Premium\u0026quot;\r\n      },\r\n      \u0026quot;dateContactCreated\u0026quot;: \u0026quot;2022-01-12T00:00:00\u0026quot;,\r\n      \u0026quot;timestampCreated\u0026quot;: \u0026quot;2022-01-12T18:10:25.56\u0026quot;,\r\n      \u0026quot;dateContactLastModified\u0026quot;: \u0026quot;2025-09-23T20:50:49.373\u0026quot;,\r\n      \u0026quot;dateLastContacted\u0026quot;: \u0026quot;2025-09-23T14:21:10.293\u0026quot;,\r\n      \u0026quot;accountId\u0026quot;: 0\r\n    },\r\n    \u0026quot;id\u0026quot;: \u0026quot;43aaf5af35f866b1edba7\u0026quot;\r\n  }\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/contact/"},"publish_status":0,"post_type":"API","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","name":"Rob Howard"},"featured_image_updating":false,"meta_description":"Create or update contacts with DailyStory using an email or phone. Easily manage custom fields and update data via API. See JSON and response examples.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"sort_order":13,"total_views":1,"date_published":"2025-09-25T16:55:31.173","date_updated":"2026-02-04T15:13:25.09","date_created":"2025-09-25T16:52:05.247"}}}