Create Visit Request (CRM)

🧾 Create Visit Request (CRM)

Endpoint: POST /api/v3/visits/request

Auth Required: ✅ Yes (Bearer Token)

📝 Description

Submits a new customer visit request on behalf of a CRM system user. This is typically used when syncing visit intents from Salesforce, Dynamics, or other external platforms into the Nexus scheduling system.

🔍 Query Parameters

None.

📥 Request Body

Content-Type: application/json

Submit visit request details as per the CreateCRMVisitDto schema.

🔧 Sample Schema

{  "<visitField>": "<value>",  "<anotherVisitField>": "<value>" }  

📤 Request Example

POST https://api.briefingedge.com/api/v3/visits/request Authorization: Bearer <token> Content-Type: application/json  {  "requestedBy": "crm-user@acme.com",  "customerAccountId": 12345,  "preferredDate": "2025-11-05" }  

✅ Success Response (200 OK)

Returns the created request or a status confirmation object.

Example:

{  "RequestID": 7890,  "Status": "Pending Review",  "SubmittedBy": "crm-user@acme.com" }  

❌ Error Responses