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 disabled by configuration

URI Parameters

NameDescriptionTypeAdditional 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
NameDescriptionTypeAdditional 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":"17b3b1b7-777d-4f85-ad80-45110dcf9621","Activity":{"ActivityType":{"Title":"Activity A","Shortcut":"AA","Frequency":0,"Signed":0},"ValidTo":"\/Date(1764198000000)\/","Description":"Some description of this activity","Attachment":null}}

application/xml

Sample: 

<Request>
  <VisitorId>17b3b1b7-777d-4f85-ad80-45110dcf9621</VisitorId>
  <Activity>
    <ActivityType>
      <Title>Activity A</Title>
      <Shortcut>AA</Shortcut>
      <Frequency>0</Frequency>
      <Signed>0</Signed>
    </ActivityType>
    <ValidTo>2025-11-27T00:00:00+01:00</ValidTo>
    <Description>Some description of this activity</Description>
  </Activity>
</Request>

text/json

Sample: 
{
  "VisitorId": "6b2ba68d-e159-4f2d-b663-1bdd07e9c3ed",
  "Activity": {
    "ActivityType": {
      "Title": "sample string 1",
      "Shortcut": "sample string 2",
      "Frequency": 3,
      "Signed": 4
    },
    "ValidTo": "2025-11-27T14:39:15.822889+01:00",
    "Description": "sample string 1",
    "Attachment": {
      "Name": "sample string 1",
      "Description": "sample string 2",
      "Path": "sample string 3",
      "Data": "QEA="
    }
  }
}

text/xml

Sample: 
<Request xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <VisitorId>6b2ba68d-e159-4f2d-b663-1bdd07e9c3ed</VisitorId>
  <Activity>
    <ActivityType>
      <Title>sample string 1</Title>
      <Shortcut>sample string 2</Shortcut>
      <Frequency>3</Frequency>
      <Signed>4</Signed>
    </ActivityType>
    <ValidTo>2025-11-27T14:39:15.822889+01:00</ValidTo>
    <Description>sample string 1</Description>
    <Attachment>
      <Name>sample string 1</Name>
      <Description>sample string 2</Description>
      <Path>sample string 3</Path>
      <Data>QEA=</Data>
    </Attachment>
  </Activity>
</Request>

Response Information

Response Codes

Http CodeError NumberDescription
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
NameDescriptionTypeAdditional information
Result

RequestResult

None.
Request

VisitorActivityCreateReq

None.

Response Formats

application/json

Sample: 
{"Result":{"Message":"Processed with result: ExecOK","Code":0,"ModelStateErr":null},"Request":{"VisitorId":"17b3b1b7-777d-4f85-ad80-45110dcf9621","Activity":{"ActivityType":{"Title":"Activity A","Shortcut":"AA","Frequency":0,"Signed":0},"ValidTo":"\/Date(1764198000000)\/","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>17b3b1b7-777d-4f85-ad80-45110dcf9621</VisitorId>
    <Activity>
      <ActivityType>
        <Title>Activity A</Title>
        <Shortcut>AA</Shortcut>
        <Frequency>0</Frequency>
        <Signed>0</Signed>
      </ActivityType>
      <ValidTo>2025-11-27T00:00:00+01:00</ValidTo>
      <Description>Some description of this activity</Description>
    </Activity>
  </Request>
</Response>

text/json

Sample: 
{
  "Result": {
    "Message": "sample string 1",
    "Code": 2,
    "ModelStateErr": [
      "sample string 1",
      "sample string 2"
    ]
  },
  "Request": {
    "VisitorId": "22e7e296-c859-4694-8502-7978fdc9e5d0",
    "Activity": {
      "ActivityType": {
        "Title": "sample string 1",
        "Shortcut": "sample string 2",
        "Frequency": 3,
        "Signed": 4
      },
      "ValidTo": "2025-11-27T14:39:15.8388346+01:00",
      "Description": "sample string 1",
      "Attachment": {
        "Name": "sample string 1",
        "Description": "sample string 2",
        "Path": "sample string 3",
        "Data": "QEA="
      }
    }
  }
}

text/xml

Sample: 
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Result>
    <Message>sample string 1</Message>
    <Code>2</Code>
    <ModelStateErr>
      <string>sample string 1</string>
      <string>sample string 2</string>
    </ModelStateErr>
  </Result>
  <Request>
    <VisitorId>22e7e296-c859-4694-8502-7978fdc9e5d0</VisitorId>
    <Activity>
      <ActivityType>
        <Title>sample string 1</Title>
        <Shortcut>sample string 2</Shortcut>
        <Frequency>3</Frequency>
        <Signed>4</Signed>
      </ActivityType>
      <ValidTo>2025-11-27T14:39:15.8388346+01:00</ValidTo>
      <Description>sample string 1</Description>
      <Attachment>
        <Name>sample string 1</Name>
        <Description>sample string 2</Description>
        <Path>sample string 3</Path>
        <Data>QEA=</Data>
      </Attachment>
    </Activity>
  </Request>
</Response>