{"Status":true,"Message":"","Response":{"post":{"postuid":"e6194067-073d-418d-a6c9-672b95a54d24","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"542e5f51-33cf-401f-aebe-4324ebe36fe4","title":"Find or Create a Contact","slug":"reference/find-or-create-a-contact","html":"\u003Cp\u003EAttempts to find and return a contact using the email address or mobile number. If a contact is not found, a new contact is created.\u003C/p\u003E\u003Cp\u003EThis API is similar to the \u003Ca href=\u0022/reference/get-a-contact-1\u0022\u003EGet a Contact\u003C/a\u003E API, but creates a new contact if a contact is not found.\u003C/p\u003E\u003Ch2 id=\u0022how_this_api_is_used\u0022\u003EHow this API is used:\u003C/h2\u003E\u003Cp\u003EFind or create by email address\u0026nbsp;\u003Ccode\u003E/api/v1/contact/upsert?email=ben@example.com\u003C/code\u003E\u003C/p\u003E\u003Cp\u003EFind or create by mobile phone\u0026nbsp;\u003Ccode\u003E/api/v1/contact/upsert?mobilephone=\u002B155512345678\u003C/code\u003E\n\n\u003C/p\u003E\u003Cdiv class=\u0022api_header\u0022\u003EQuery 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\u003Eemail\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EEither an email address or mobile phone number must be provided.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Emobilephone\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EEither an email address or mobile phone number must be provided.\u003C/div\u003E\u003C/section\u003E\u003C/section\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;id\u0026quot;: \u0026quot;5a0d669ab6984125a1c63aaacfd0a9cd\u0026quot;\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response 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\u003EResponse.id\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe dsid of the contact that was updated or created.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cp\u003E\u003C/p\u003E","json_meta":{"api_verb":"POST","api_path":"https://us-1.dailystory.com/api/v1/contact/upsert"},"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":"Find or create a contact by email or mobile. If not found, a new contact is created. See required parameters and response for upsert contact API.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"sort_order":14,"total_views":0,"date_published":"2026-02-04T15:12:01.053","date_updated":"2026-02-04T15:12:03.937","date_created":"2026-02-04T15:05:20.313"}}}