--- schema_version: "1" id: e109053a376e49913ffeddfab63b3b58f4e89a99b9e2fca6ff800a9681550bab title: Visits (POST) collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/connect_resources_create_visit.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_resources_create_visit.htm source_site: developer.salesforce.com content_type: documentation content_hash: 34037829a05f210bc5952c2f92f9d1bf9a32294f806616e69d83b557d96a5b15 description: Create visits for sales representatives. For example, for a medical device visit, a sales representative visits the surgeon or a hospital location. --- # Visits (POST) Create visits for sales representatives. For example, for a medical device visit, a sales representative visits the surgeon or a hospital location. ## Resource /connect/general-visit/visits ## Resource Example Replace {yourInstance.salesforce.com} with the My Domain host of your Salesforce org, and replace {XX.X} with the API version. https://{yourInstance.salesforce.com}/services/data/v{XX.X}/connect/general-visit/visits ## Available Version 55.0 ## Requires Chatter No ## HTTP Methods POST ## Request Body for POST ### Root XML tag ### JSON Example { "visitType": "08qSG00000017VhYAI", "place": "131SG0000006yazYAA", "plannedVisitStartTime": "2023-12-28T09:07:21.205-07:00", "status": "Planned", "account": "001SG00000Cq7T8YAJ", "visitor": \[ { "user": "005SG000003Z0p9YAC", "primary": true } \], "productRequired": \[ { "productId": "01tSG000000KOxRYAW", "quantity": 1 } \] } ### Properties

Name	Type	Description	Required or Optional	Available Version
`account`	String	ID of the account that is associated with a visit.	Required	55.0
`actionPlanTemplate`	Action Plan Template Input	Represents the details of an action plan template. Action plan templates define the sets of tasks that your sales reps perform during visits.	Optional	55.0
`context`	String	Purpose of the visit, such as claim or work type.	Optional	55.0
`place`	String	Indicates the place that sales representatives visit.	Required	55.0
`plannedVisitEndTime`	String	Date and time when the visit is expected to end.	Optional	55.0
`plannedVisitStartTime`	String	Date and time when the visit is expected to start.	Required	55.0
`productRequired`	Product Required Attributes Input[]	Represents the products required for the visit.	Required	55.0
`status`	String	Indicates the status of the visit. Valid values are: `Abondoned` `Completed` `InProgress` `Planned`	Optional	55.0
`statusRemarks`	String	Additional remarks or comments provided by the sales representatives.	Optional	55.0
`visitPriority`	String	Priority of the visit. Valid values are: `High` `Low` `Medium`	Optional	55.0
`visitType`	String	ID of the visit type. This field is a lookup to the Worktype object.	Optional	55.0
`visitedParty`	Visited Party Attributes Input[]	Represents the contacts from the customer organization who are being visited.	Optional	55.0
`visitor`	Visitor Attributes Input[]	Represents the service resources from the organization who are executing the visit.	Required	55.0

## Response Body for POST [Create Visit Output](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_responses_create_visit_output.htm "Output representation of the create visit request.")