{"openapi":"3.0.0","info":{"version":"1.0.0","title":"Marketing Ecosystem API"},"servers":[{"url":"http://localhost:8787","description":"Development"},{"url":"https://staging.ecosystem.rdstation.com","description":"Staging"},{"url":"https://ecosystem.rdstation.com","description":"Production"}],"components":{"schemas":{},"parameters":{}},"paths":{"/v1/visitors/profile":{"get":{"tags":["Visitors"],"summary":"Get Visitor Profile (structured data) -- WILL DEPRECATE, USE LEAD","description":"Busca pelo perfil do visitante (rdsm + customer info)","parameters":[{"schema":{"type":"string","format":"email","example":"example@domain.com"},"required":true,"name":"email","in":"query"}],"responses":{"200":{"description":"Visitor profile retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"company":{"type":"string"},"job_role":{"type":"string"},"area_de_atuacao_da_empresa":{"type":"string"},"profile":{"type":"object","properties":{"rdsm":{"type":"object","properties":{"score":{"type":"object","properties":{"icp":{"type":"string"}},"required":["icp"]},"tags":{"type":"array","items":{"type":"string"}}}},"billing":{"type":"object","properties":{"rdsm":{"type":"object","properties":{"status":{"type":"string","enum":["current","ex","never"]},"stage":{"type":"string"},"plan":{"type":"string"},"premium":{"type":"boolean"},"entryLevel":{"type":"boolean"},"partner":{"type":"boolean"}}},"rdscrm":{"type":"object","properties":{"status":{"type":"string","enum":["current","ex","never"]},"stage":{"type":"string"},"plan":{"type":"string"},"premium":{"type":"boolean"},"entryLevel":{"type":"boolean"},"partner":{"type":"boolean"}}}}}},"required":["rdsm","billing"]}},"required":["email","profile"]},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Visitor not found"}}}},"/v1/lead/profile":{"get":{"tags":["Lead"],"summary":"Get Lead Profile (structured data)","description":"Busca pelo perfil do visitante (rdsm + customer info)","parameters":[{"schema":{"type":"string","format":"email","example":"example@domain.com"},"required":true,"name":"email","in":"query"}],"responses":{"200":{"description":"Lead profile retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"company":{"type":"string"},"job_role":{"type":"string"},"area_de_atuacao_da_empresa":{"type":"string"},"profile":{"type":"object","properties":{"rdsm":{"type":"object","properties":{"score":{"type":"object","properties":{"icp":{"type":"string"}},"required":["icp"]},"tags":{"type":"array","items":{"type":"string"}}}},"billing":{"type":"object","properties":{"rdsm":{"type":"object","properties":{"status":{"type":"string","enum":["current","ex","never"]},"stage":{"type":"string"},"plan":{"type":"string"},"premium":{"type":"boolean"},"entryLevel":{"type":"boolean"},"partner":{"type":"boolean"}}},"rdscrm":{"type":"object","properties":{"status":{"type":"string","enum":["current","ex","never"]},"stage":{"type":"string"},"plan":{"type":"string"},"premium":{"type":"boolean"},"entryLevel":{"type":"boolean"},"partner":{"type":"boolean"}}}}}},"required":["rdsm","billing"]}},"required":["email","profile"]},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Lead not found"}}}},"/v1/lead/rdsm":{"get":{"tags":["Lead"],"summary":"Get Lead Data (raw rdsm data)","description":"Busca pelo lead no RDSM trazendo todos os campos","parameters":[{"schema":{"type":"string","format":"email","example":"example@domain.com","description":"E-mail do visitante"},"required":true,"description":"E-mail do visitante","name":"email","in":"query"}],"responses":{"200":{"description":"Lead raw data found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"name":{"type":"string"},"personal_phone":{"type":"string"},"phone":{"type":"string"},"job_title":{"type":"string"},"website":{"type":"string"},"cf_empresa":{"type":"string"},"cf_mdw_crm_plan_name":{"type":"string"},"cf_mdw_marketing_plan_name":{"type":"string"},"cf_rdu_user_id":{"type":"string"},"cf_rdu_curso_finalizado":{"type":"string"},"cf_mdw_lead_type":{"type":"string"},"cf_mdw_is_partner":{"type":"string"},"cf_mdw_crm_is_customer":{"type":"boolean"},"cf_mdw_marketing_is_customer":{"type":"boolean"},"cf_numero_de_funcionarios":{"type":"string"},"cf_icp_score":{"type":"string"},"cf_area_de_atuacao_da_empresa":{"type":"string"},"errors":{"type":"boolean"}},"required":["name","personal_phone","phone","job_title","website","cf_empresa"]},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Visitor not found"}}}},"/v1/devices":{"post":{"tags":["Devices"],"summary":"Create or Update Device","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"properties":{"type":"object","additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Device updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]},"message":{"type":"string"}},"required":["success"]}}}},"201":{"description":"Device created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]},"message":{"type":"string"}},"required":["success"]}}}},"400":{"description":"Failed to create device"}}},"get":{"tags":["Devices"],"summary":"List Devices","parameters":[{"schema":{"type":"string","description":"Page number","example":"1"},"required":false,"description":"Page number","name":"page","in":"query"},{"schema":{"type":"string","format":"email","description":"Filter devices by email","example":"user@email.com"},"required":false,"description":"Filter devices by email","name":"email","in":"query"}],"responses":{"200":{"description":"Devices retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]}},"page":{"type":"number"},"perPage":{"type":"number"},"totalItems":{"type":"number"}},"required":["list","page","perPage","totalItems"]}}}}}}},"/v1/devices/{id}":{"get":{"tags":["Devices"],"summary":"Get Device by ID","parameters":[{"schema":{"type":"string","description":"Device ID","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"Device ID","name":"id","in":"path"}],"responses":{"200":{"description":"Device retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]},"message":{"type":"string"}},"required":["success"]}}}},"404":{"description":"Device not found"}}},"put":{"tags":["Devices"],"summary":"Update Device","parameters":[{"schema":{"type":"string","description":"Device ID","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"Device ID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"properties":{"type":"object","additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Device updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]},"message":{"type":"string"}},"required":["success"]}}}},"404":{"description":"Device not found"}}}},"/v1/internal/devices/{id}":{"put":{"tags":["Devices"],"summary":"Update Device","parameters":[{"schema":{"type":"string","description":"Device ID","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"Device ID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"properties":{"type":"object","additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Device updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"main_email":{"type":"string","nullable":true},"emails":{"type":"string","nullable":true},"properties":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","main_email","emails","properties","createdAt","updatedAt"]},"message":{"type":"string"}},"required":["success"]}}}},"404":{"description":"Device not found"}}}},"/v1/rdsm/fields":{"get":{"tags":["RDSM"],"summary":"Get RDSM Fields","description":"Busca os campos da conta do rdsm","responses":{"200":{"description":"Fields data found successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"placeholder":{"type":"string"},"mode":{"type":"string","enum":["default","virtual"]},"type":{"type":"string","enum":["text","checkbox","radio","select","textarea"]},"label":{"type":"string"},"options":{"type":"array","nullable":true,"items":{"type":"object","properties":{"value":{"type":"string","nullable":true},"altLabel":{"type":"string","nullable":true},"id":{"type":"string","nullable":true}}}}},"required":["id","mode","type","label"]}}}}},"404":{"description":"Fields not found"}}}},"/v1/rdsm/landing-pages":{"get":{"tags":["RDSM"],"summary":"Get landing pages","description":"Busca landing pages do RDSM","parameters":[{"schema":{"type":"string","nullable":true},"required":false,"name":"page","in":"query"}],"responses":{"200":{"description":"Lead raw data found successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"path":{"type":"string"},"status":{"type":"string"},"fetchedAt":{"type":"string"},"form":{"anyOf":[{"type":"string"},{"nullable":true},{"nullable":true}]},"identifiers":{"anyOf":[{"type":"object","additionalProperties":{"nullable":true}},{"type":"array","items":{"nullable":true}},{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]},"actions":{"anyOf":[{"type":"object","additionalProperties":{"nullable":true}},{"type":"array","items":{"nullable":true}},{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]},"formSettings":{"type":"object","properties":{"variation":{"type":"string","nullable":true,"enum":["rdstation","highlight","rdstation-new","highlight-new",null]},"variationType":{"type":"string","nullable":true,"enum":["primary","secondary","tertiary",null]},"buttonSize":{"type":"string","nullable":true,"enum":["default","small",null]},"breadcrumbsColor":{"type":"string","nullable":true,"enum":["default","new-brand","dark","light",null]},"breadcrumbsSize":{"type":"string","nullable":true,"enum":["default","small",null]},"theme":{"type":"string","nullable":true,"enum":["light","dark",null]}}}},"required":["id","name","domain","path","status","fetchedAt"]}}}}},"404":{"description":"Visitor not found"}}}},"/v1/rdsm/lead":{"get":{"tags":["RDSM"],"summary":"Get Lead by Email (raw rdsm data) -- WILL DEPRECATE, USE LEAD","description":"Busca pelo lead no RDSM trazendo todos os campos","parameters":[{"schema":{"type":"string","format":"email","example":"example@domain.com","description":"E-mail do visitante"},"required":true,"description":"E-mail do visitante","name":"email","in":"query"}],"responses":{"200":{"description":"Lead raw data found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"name":{"type":"string"},"personal_phone":{"type":"string"},"phone":{"type":"string"},"job_title":{"type":"string"},"website":{"type":"string"},"cf_empresa":{"type":"string"},"cf_mdw_crm_plan_name":{"type":"string"},"cf_mdw_marketing_plan_name":{"type":"string"},"cf_rdu_user_id":{"type":"string"},"cf_rdu_curso_finalizado":{"type":"string"},"cf_mdw_lead_type":{"type":"string"},"cf_mdw_is_partner":{"type":"string"},"cf_mdw_crm_is_customer":{"type":"boolean"},"cf_mdw_marketing_is_customer":{"type":"boolean"},"cf_numero_de_funcionarios":{"type":"string"},"cf_icp_score":{"type":"string"},"cf_area_de_atuacao_da_empresa":{"type":"string"},"errors":{"type":"boolean"}},"required":["name","personal_phone","phone","job_title","website","cf_empresa"]},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Visitor not found"}}}},"/v1/analytics":{"post":{"tags":["Analytics"],"summary":"Create Event","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deviceId":{"type":"string"},"event":{"type":"object","properties":{"eventName":{"type":"string","example":"page_view"},"origin":{"type":"string","description":"Origin of the event","example":"https://www.example.com"},"properties":{"type":"object","properties":{},"description":"Additional properties related to the event","example":{"property1":"value","property2":"value","property3":"value"}}},"required":["eventName"]},"device":{"type":"object","properties":{"properties":{"type":"object","additionalProperties":{"nullable":true}}}}},"required":["event"]}}}},"responses":{"201":{"description":"Event created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"deviceId":{"type":"string"},"eventName":{"type":"string"},"origin":{"type":"string"},"properties":{"type":"object","properties":{}}},"required":["id","deviceId","eventName","origin","properties"]},"message":{"type":"string"}},"required":["success"]}}}},"400":{"description":"Failed to register event"}}},"get":{"tags":["Analytics"],"summary":"Lista os eventos do banco de dados","parameters":[{"schema":{"type":"string","description":"Page number for pagination","example":1},"required":false,"description":"Page number for pagination","name":"page","in":"query"},{"schema":{"type":"string","format":"email","description":"Filter events by email","example":"user@email.com"},"required":false,"description":"Filter events by email","name":"email","in":"query"},{"schema":{"type":"string","description":"Filter events by event name","example":"page_view"},"required":false,"description":"Filter events by event name","name":"eventName","in":"query"},{"schema":{"type":"string","description":"Filter events by page URL (origin)","example":"https://www.example.com"},"required":false,"description":"Filter events by page URL (origin)","name":"origin","in":"query"},{"schema":{"type":"string","description":"Filter events by page group","example":"/planos/marketing, /planos/lead"},"required":false,"description":"Filter events by page group","name":"pageGroup","in":"query"},{"schema":{"type":"string","description":"Filter events by campaign name","example":"campaign-name-123"},"required":false,"description":"Filter events by campaign name","name":"campaignName","in":"query"},{"schema":{"type":"string","description":"Filter events by UTM medium","example":"cpc"},"required":false,"description":"Filter events by UTM medium","name":"utmMedium","in":"query"},{"schema":{"type":"string","description":"Filter events by UTM source","example":"google"},"required":false,"description":"Filter events by UTM source","name":"utmSource","in":"query"},{"schema":{"type":"string","description":"Filter events from this date (YYYY-MM-DD)","example":"2025-01-01"},"required":false,"description":"Filter events from this date (YYYY-MM-DD)","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Filter events up to this date (YYYY-MM-DD)","example":"2025-12-31"},"required":false,"description":"Filter events up to this date (YYYY-MM-DD)","name":"toDate","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"description":"Sort order for events","example":"desc"},"required":false,"description":"Sort order for events","name":"sortBy","in":"query"}],"responses":{"200":{"description":"Events found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"deviceId":{"type":"string"},"eventName":{"type":"string"},"origin":{"type":"string"},"properties":{"type":"object","properties":{}}},"required":["id","deviceId","eventName","origin","properties"]}},"page":{"type":"number"},"perPage":{"type":"number"},"totalItems":{"type":"number"}},"required":["list","page","perPage","totalItems"]}}}},"404":{"description":"Events not found"}}}},"/v1/analytics/device":{"get":{"tags":["Analytics"],"summary":"Lista eventos por dispositivo","parameters":[{"schema":{"type":"string","description":"ID do dispositivo","example":"device-12345"},"required":true,"description":"ID do dispositivo","name":"deviceId","in":"query"},{"schema":{"type":"string","description":"Page number for pagination","example":1},"required":false,"description":"Page number for pagination","name":"page","in":"query"}],"responses":{"200":{"description":"Events found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"deviceId":{"type":"string"},"eventName":{"type":"string"},"origin":{"type":"string"},"properties":{"type":"object","properties":{}}},"required":["id","deviceId","eventName","origin","properties"]}},"page":{"type":"number"},"perPage":{"type":"number"},"totalItems":{"type":"number"}},"required":["list","page","perPage","totalItems"]}}}},"404":{"description":"Events not found"}}}},"/v1/analytics/stats":{"get":{"tags":["Analytics"],"summary":"Lista estatísticas de eventos por página","parameters":[{"schema":{"type":"string","description":"Page number for pagination","example":1},"required":false,"description":"Page number for pagination","name":"page","in":"query"},{"schema":{"type":"string","description":"Filter events by page group","example":"/planos/marketing, /planos/lead"},"required":false,"description":"Filter events by page group","name":"pageGroup","in":"query"},{"schema":{"type":"string","description":"Count unique visitors (1x by deviceId) instead of total events","example":"false"},"required":false,"description":"Count unique visitors (1x by deviceId) instead of total events","name":"uniqueVisitors","in":"query"},{"schema":{"type":"string","description":"Filter events from this date (YYYY-MM-DD)","example":"2025-01-01"},"required":false,"description":"Filter events from this date (YYYY-MM-DD)","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Filter events up to this date (YYYY-MM-DD)","example":"2025-12-31"},"required":false,"description":"Filter events up to this date (YYYY-MM-DD)","name":"toDate","in":"query"}],"responses":{"200":{"description":"Events stats found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"deviceId":{"type":"string"},"eventName":{"type":"string"},"origin":{"type":"string"},"properties":{"type":"object","properties":{}}},"required":["id","deviceId","eventName","origin","properties"]}},"page":{"type":"number"},"perPage":{"type":"number"},"totalItems":{"type":"number"}},"required":["list","page","perPage","totalItems"]}}}},"404":{"description":"Events stats not found"}}}},"/v1/chat/working-hours":{"get":{"tags":["Chat"],"summary":"Get chat Working Hours","responses":{"200":{"description":"Working hours found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"isWorkingHours":{"type":"boolean"},"now":{"type":"string","format":"date-time"}},"required":["isWorkingHours","now"]}}}},"404":{"description":"Working hours not found"}}}},"/v1/conversions":{"post":{"tags":["Conversions"],"summary":"Register a conversion on DB","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"object","properties":{"email":{"type":"string","format":"email"},"conversion_identifier":{"type":"string","minLength":3,"maxLength":100},"conversion_uuid":{"type":"string"},"source_asset":{"type":"string"}},"required":["email","conversion_identifier"],"additionalProperties":{"nullable":true}},"account":{"type":"string","enum":["marketing","partner","latam"]}},"required":["payload","account"]}}}},"responses":{"201":{"description":"Conversion added successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success"]}}}},"404":{"description":"Visitor not found"}}},"get":{"tags":["Conversions"],"summary":"Get Conversions (paginated)","parameters":[{"schema":{"type":"string","description":"Page number"},"required":false,"description":"Page number","name":"page","in":"query"},{"schema":{"type":"string","description":"Filter conversions by page group","example":"marketing, lead"},"required":false,"description":"Filter conversions by page group","name":"pageGroup","in":"query"},{"schema":{"type":"string","description":"Filter conversions from this date (YYYY-MM-DD)","example":"2025-01-01"},"required":false,"description":"Filter conversions from this date (YYYY-MM-DD)","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Filter conversions up to this date (YYYY-MM-DD)","example":"2025-12-31"},"required":false,"description":"Filter conversions up to this date (YYYY-MM-DD)","name":"toDate","in":"query"},{"schema":{"type":"string","description":"Filter conversions by conversion identifier","example":"newsletter-signup"},"required":false,"description":"Filter conversions by conversion identifier","name":"conversionIdentifier","in":"query"},{"schema":{"type":"string","format":"email","description":"Filter conversions by email","example":"user@email.com"},"required":false,"description":"Filter conversions by email","name":"email","in":"query"},{"schema":{"type":"string","description":"Filter conversions by device ID","example":"device-uuid-123"},"required":false,"description":"Filter conversions by device ID","name":"deviceId","in":"query"}],"responses":{"200":{"description":"Conversions found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"date":{"type":"string"},"email":{"type":"string","format":"email"},"conversion_success":{"type":"integer"},"conversion_identifier":{"type":"string","nullable":true},"payload":{"type":"string","nullable":true},"history":{"type":"string","nullable":true}},"required":["uuid","date","email","conversion_success","conversion_identifier","payload","history"],"description":"New conversion"}},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Conversions not found"}}}},"/v1/pre-conversions":{"post":{"tags":["Pre-Conversion"],"summary":"Register Pre-Conversion on DB","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"conversion_identifier":{"type":"string","minLength":3,"maxLength":100},"payload":{"type":"string","minLength":3}},"required":["email","conversion_identifier","payload"]}}}},"responses":{"201":{"description":"Pre-conversion created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"uuid":{"type":"string"}},"required":["uuid"]},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Pre-conversion not created"}}},"get":{"tags":["Pre-Conversion"],"summary":"Get Pre-Conversions (paginated)","parameters":[{"schema":{"type":"string","minLength":1,"description":"Page number"},"required":false,"description":"Page number","name":"page","in":"query"},{"schema":{"type":"string","description":"Filter pre-conversions by page group","example":"marketing, lead"},"required":false,"description":"Filter pre-conversions by page group","name":"pageGroup","in":"query"},{"schema":{"type":"string","description":"Filter pre-conversions from this date (YYYY-MM-DD)","example":"2025-01-01"},"required":false,"description":"Filter pre-conversions from this date (YYYY-MM-DD)","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Filter pre-conversions up to this date (YYYY-MM-DD)","example":"2025-12-31"},"required":false,"description":"Filter pre-conversions up to this date (YYYY-MM-DD)","name":"toDate","in":"query"},{"schema":{"type":"string","description":"Filter pre-conversions by conversion identifier","example":"newsletter-signup"},"required":false,"description":"Filter pre-conversions by conversion identifier","name":"conversionIdentifier","in":"query"},{"schema":{"type":"string","format":"email","description":"Filter pre-conversions by email","example":"user@email.com"},"required":false,"description":"Filter pre-conversions by email","name":"email","in":"query"},{"schema":{"type":"string","description":"Filter pre-conversions by device ID","example":"device-uuid-123"},"required":false,"description":"Filter pre-conversions by device ID","name":"deviceId","in":"query"}],"responses":{"200":{"description":"Pre-conversions found successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"conversion_id":{"type":"string"},"date":{"type":"string"},"email":{"type":"string"},"conversion_identifier":{"type":"string"},"payload":{"anyOf":[{"type":"string"},{"type":"object","properties":{}}]}},"required":["conversion_id","date"]}},"message":{"type":"string"}},"required":["success","data"]}}}},"404":{"description":"Pre-conversions not found"}}}},"/v1/forms/first-step/{id}":{"get":{"summary":"Get First Step Fields","parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"201":{"description":"Field created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"hasForm":{"type":"boolean"},"data":{"type":"object","properties":{"formId":{"type":"string"},"mode":{"type":"string"},"firstStepFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"placeholder":{"type":"string"},"mode":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"options":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"id":{"type":"string"}}},"updatedAt":{"type":"string"},"createdAt":{"type":"string"},"isRequired":{"type":"boolean"}},"required":["id","mode","type","label","updatedAt","createdAt","isRequired"]}},"formSettings":{"type":"object","properties":{"variation":{"type":"string"},"variationType":{"type":"string"},"buttonSize":{"type":"string"},"breadcrumbsColor":{"type":"string"},"breadcrumbsSize":{"type":"string"},"theme":{"type":"string"}},"required":["variation","variationType","buttonSize","breadcrumbsColor","breadcrumbsSize","theme"]}},"required":["formId","mode","firstStepFields","formSettings"]}},"required":["hasForm","data"]}}}},"404":{"description":"Field not created"}}}},"/v1/forms/second-step/{id}":{"post":{"summary":"Get Second Step Fields","parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"firstStepFieldValues":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}}},"required":["firstStepFieldValues"]}}}},"responses":{"200":{"description":"Second step fields retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/fieldsSchema"},"fixed":{"type":"boolean"},"isRequired":{"type":"boolean"},"useAltLabel":{"type":"boolean"},"hasConditionalFields":{"type":"boolean"},"occultField":{"type":"boolean"},"conditionalFields":{"type":"array","items":{"$ref":"#/components/schemas/rawFieldsSchema"}},"id":{"type":"string"}}}},"conversionIdentifier":{"type":"string"},"conversionUUID":{"type":"string"}},"required":["fields","conversionIdentifier","conversionUUID"]}},"required":["data"]}}}},"404":{"description":"Form not found"}}}}}}