POST visitor/createActivity?Token={Token}

Create visitor activity. Agenda "Visit" has to be licensed. Privilege "Edit" of licensed agenda "Visitors - Persons" required. Privilege "Edit" of item "Activities" of licensed agenda "Visitors - Persons" required. Functionality may also be restricted by record permission "Edit" of agenda "Visitors - Persons"

Request Information

Authorization

Authorization by token required

Availability

Method can be used

URI Parameters

Name	Description	Type	Additional information
Token	The action is authorized by this token. Token should generated by calling action "POST login". Expiration time of each token is 20 seconds	globally unique identifier	Required

Body Parameters

VisitorActivityCreateReq

Name	Description	Type	Additional information
VisitorId	Unique identification of the visitor in the system	globally unique identifier	Required Matching regular expression pattern: ^({){0,1}[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}(}){0,1}$
Activity	Visitor activity encapsulating object	VisitorActivity	Required

Name

Description

Type

Additional information

VisitorId

Unique identification of the visitor in the system

globally unique identifier

Required

Matching regular expression pattern: ^({){0,1}[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}(}){0,1}$

Activity

Visitor activity encapsulating object

VisitorActivity

Required

Request Formats

application/json

Sample:

{"VisitorId":"468985bf-eabf-4656-b014-4b2b8d29807d","Activity":{"ActivityType":{"Title":"Activity A","Shortcut":"AA","Frequency":0,"Signed":0},"ValidTo":"\/Date(1761778800000)\/","Description":"Some description of this activity","Attachment":null}}

application/xml

Sample:


<Request>
  <VisitorId>468985bf-eabf-4656-b014-4b2b8d29807d</VisitorId>
  <Activity>
    <ActivityType>
      <Title>Activity A</Title>
      <Shortcut>AA</Shortcut>
      <Frequency>0</Frequency>
      <Signed>0</Signed>
    </ActivityType>
    <ValidTo>2025-10-30T00:00:00+01:00</ValidTo>
    <Description>Some description of this activity</Description>
  </Activity>
</Request>

Response Information

Response Codes

Http Code	Error Number	Description
200 request succesfully done	0	Successfully done
400 bad request	1002	Entry parameter missing or parameter bindigs failed
401 unauthorized	1000	Token {0} not found
401 unauthorized	1001	Token {0} already expired
401 unauthorized	1006	Ip filter violated for ip client address [{0}]
401 unauthorized	1007	Ip filter [{0}] parsing failed
401 unauthorized	1008	Request rate policy violated for [{0}]
403 server refuses fo fulfill the request	1536	Privilege Edit of agenda Visitors-Persons violated for [Visitor Id{0}]
403 server refuses fo fulfill the request	1535	Privilege Edit of item Activities of agenda Visitors-Persons violated for [VisitorId {0}]
403 server refuses fo fulfill the request	1539	Record permission Edit of agenda Visitor - Persons violated for [{0}]
403 server refuses fo fulfill the request	1525	Create activity of type [{0}] for visitor [{1}] failed. Exception:{2}
403 server refuses fo fulfill the request	8	Not licensed
404 required resource does not exist on the server	1100	PersonId [{0}] not found
415 unsupported Media Type		The request entity has a media type which the server or resource does not support. Only application/json and application/xml are supported
500 internal error		Server exception description

Resource Description

BaseRespOfVisitorActivityCreateReq

Name	Description	Type	Additional information
Result		RequestResult	None.
Request		VisitorActivityCreateReq	None.

Response Formats

application/json

Sample:

{"Result":{"Message":"Processed with result: ExecOK","Code":0,"ModelStateErr":null},"Request":{"VisitorId":"468985bf-eabf-4656-b014-4b2b8d29807d","Activity":{"ActivityType":{"Title":"Activity A","Shortcut":"AA","Frequency":0,"Signed":0},"ValidTo":"\/Date(1761778800000)\/","Description":"Some description of this activity","Attachment":null}}}

application/xml

Sample:


<Response>
  <Result>
    <Message>Processed with result: ExecOK</Message>
    <Code>0</Code>
  </Result>
  <Request>
    <VisitorId>468985bf-eabf-4656-b014-4b2b8d29807d</VisitorId>
    <Activity>
      <ActivityType>
        <Title>Activity A</Title>
        <Shortcut>AA</Shortcut>
        <Frequency>0</Frequency>
        <Signed>0</Signed>
      </ActivityType>
      <ValidTo>2025-10-30T00:00:00+01:00</ValidTo>
      <Description>Some description of this activity</Description>
    </Activity>
  </Request>
</Response>