POST api/users/{id}/confirmation

POST api/users/{id:guid}/confirmation Records in CRM that the given user has successfully been confirmed as a member of said organisation on the website If successful returns 202 Accepted with the updated user in the body If backend user record exists but is not in a state from which there is a valid "Confirmation" transition, then returns conflict with a helpful error message. the backend (so cannot be confirmed) returns 404 Not Found. If the user's organsiation does not exist in the backend (so cannot be confirmed) returns 402 Bad Request. Other CRM errors give 502 bad gateway, any other errors 500 Server Error

Request Information

URI Parameters

Name	Description	Type	Additional information
id		string	None.

Body Parameters

User

Name	Type	Additional information
Id	globally unique identifier	None.
IdSource	integer	None.
Login	string	None.
FirstName	string	None.
LastName	string	None.
Email	string	None.
Telephone	string	None.
OrgMemberNumber	string	None.
OrgId	globally unique identifier	None.
StatusValue	integer	None.
StatusLabel	string	None.
JobTitle	string	None.
JobRole	globally unique identifier	None.
InvitationCode	globally unique identifier	None.
XrmContactId	globally unique identifier	None.

Request Formats

application/json, text/json

Sample:

{
  "Id": "5402cd41-a42b-40b9-a8a3-e58c46536128",
  "IdSource": 2,
  "Login": "sample string 3",
  "FirstName": "sample string 4",
  "LastName": "sample string 5",
  "Email": "sample string 6",
  "Telephone": "sample string 7",
  "OrgMemberNumber": "sample string 8",
  "OrgId": "2921cf36-333c-4330-8f70-0eaf837fabd1",
  "StatusValue": 9,
  "StatusLabel": "sample string 10",
  "JobTitle": "sample string 11",
  "JobRole": "fb48fff1-a353-4f04-bd9f-adcef122b8a8",
  "InvitationCode": "a97c340e-0b3a-4e27-829e-fa93829487f5",
  "XrmContactId": "8f724ecb-e819-493a-ae36-eaaa8dc59efd"
}

application/xml, text/xml

Sample:

<User xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSAT.Webservices.Domain">
  <Email>sample string 6</Email>
  <FirstName>sample string 4</FirstName>
  <Id>5402cd41-a42b-40b9-a8a3-e58c46536128</Id>
  <IdSource>2</IdSource>
  <InvitationCode>a97c340e-0b3a-4e27-829e-fa93829487f5</InvitationCode>
  <JobRole>fb48fff1-a353-4f04-bd9f-adcef122b8a8</JobRole>
  <JobTitle>sample string 11</JobTitle>
  <LastName>sample string 5</LastName>
  <Login>sample string 3</Login>
  <OrgId>2921cf36-333c-4330-8f70-0eaf837fabd1</OrgId>
  <OrgMemberNumber>sample string 8</OrgMemberNumber>
  <StatusLabel>sample string 10</StatusLabel>
  <StatusValue>9</StatusValue>
  <Telephone>sample string 7</Telephone>
  <XrmContactId>8f724ecb-e819-493a-ae36-eaaa8dc59efd</XrmContactId>
</User>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'User'.

Response Information

Resource Description

UserRepresentation

Name	Description	Type	Additional information
Id	Unique identifier - same as in CRM	globally unique identifier	None.
LocalLogin	Login for this system	string	None.
IdSource	The source of identity for this user. Defined values are: 0 = reserved for test suites; 1 = SSAT website	integer	None.
FirstName	First name	string	None.
LastName	last name	string	None.
Email	Email address	string	None.
Telephone	Main telephone number	string	None.
OrgMemberNumber	Organisation membership number	string	None.
OrgId	Organisation ID	globally unique identifier	None.
StatusValue	User status	integer	None.
StatusLabel	User status label	string	None.
JobTitle	Free text job title	string	None.
JobRole	Reference to job role from pre-set list	globally unique identifier	None.
InvitationCode	Most recent invitation code generated by CRM	globally unique identifier	None.
XrmContactId	Unique XRM Id for the associated contact (NB N:1 User:Contact)	globally unique identifier	None.
Links		Collection of Link	None.

Response Formats

application/json

Sample:

{
  "Id": "ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1",
  "LocalLogin": "sample string 2",
  "IdSource": 3,
  "FirstName": "sample string 4",
  "LastName": "sample string 5",
  "Email": "sample string 6",
  "Telephone": "sample string 7",
  "OrgMemberNumber": "sample string 8",
  "OrgId": "653b866d-1c2c-4413-aeaf-00f89bcc1168",
  "StatusValue": 9,
  "StatusLabel": "sample string 10",
  "JobTitle": "sample string 11",
  "JobRole": "49e4da53-f3a7-4547-9452-eb8848bf7c95",
  "InvitationCode": "1ef07b2a-bfca-44e2-927e-1d411be181fe",
  "XrmContactId": "ed947ded-ebf8-421a-b5f6-61db122e8280",
  "_links": [
    {
      "Rel": "self",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "sample string 1",
      "Href": "sample string 2",
      "Title": "sample string 3",
      "IsTemplated": false
    },
    {
      "Rel": "sample string 1",
      "Href": "sample string 2",
      "Title": "sample string 3",
      "IsTemplated": false
    },
    {
      "Rel": "roles",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "subjects",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects",
      "Title": null,
      "IsTemplated": false
    }
  ],
  "_embedded": null
}

text/json

Sample:

{
  "Id": "ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1",
  "LocalLogin": "sample string 2",
  "IdSource": 3,
  "FirstName": "sample string 4",
  "LastName": "sample string 5",
  "Email": "sample string 6",
  "Telephone": "sample string 7",
  "OrgMemberNumber": "sample string 8",
  "OrgId": "653b866d-1c2c-4413-aeaf-00f89bcc1168",
  "StatusValue": 9,
  "StatusLabel": "sample string 10",
  "JobTitle": "sample string 11",
  "JobRole": "49e4da53-f3a7-4547-9452-eb8848bf7c95",
  "InvitationCode": "1ef07b2a-bfca-44e2-927e-1d411be181fe",
  "XrmContactId": "ed947ded-ebf8-421a-b5f6-61db122e8280",
  "_links": [
    {
      "Rel": "self",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "sample string 1",
      "Href": "sample string 2",
      "Title": "sample string 3",
      "IsTemplated": false
    },
    {
      "Rel": "sample string 1",
      "Href": "sample string 2",
      "Title": "sample string 3",
      "IsTemplated": false
    },
    {
      "Rel": "roles",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "subjects",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "roles",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles",
      "Title": null,
      "IsTemplated": false
    },
    {
      "Rel": "subjects",
      "Href": "~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects",
      "Title": null,
      "IsTemplated": false
    }
  ],
  "_embedded": null
}

application/xml

Sample:

<UserRepresentation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSAT.WebServices.WebApp.Representations.Version1">
  <Href xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Href>
  <LinkName xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 15</LinkName>
  <Links xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Href>
      <Rel>self</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>sample string 2</Href>
      <Rel>sample string 1</Rel>
      <Title>sample string 3</Title>
    </Link>
    <Link>
      <Href>sample string 2</Href>
      <Rel>sample string 1</Rel>
      <Title>sample string 3</Title>
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
  </Links>
  <Rel xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 13</Rel>
  <Email>sample string 6</Email>
  <FirstName>sample string 4</FirstName>
  <Id>ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Id>
  <IdSource>3</IdSource>
  <InvitationCode>1ef07b2a-bfca-44e2-927e-1d411be181fe</InvitationCode>
  <JobRole>49e4da53-f3a7-4547-9452-eb8848bf7c95</JobRole>
  <JobTitle>sample string 11</JobTitle>
  <LastName>sample string 5</LastName>
  <LocalLogin>sample string 2</LocalLogin>
  <OrgId>653b866d-1c2c-4413-aeaf-00f89bcc1168</OrgId>
  <OrgMemberNumber>sample string 8</OrgMemberNumber>
  <StatusLabel>sample string 10</StatusLabel>
  <StatusValue>9</StatusValue>
  <Telephone>sample string 7</Telephone>
  <XrmContactId>ed947ded-ebf8-421a-b5f6-61db122e8280</XrmContactId>
</UserRepresentation>

text/xml

Sample:

<UserRepresentation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSAT.WebServices.WebApp.Representations.Version1">
  <Href xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Href>
  <LinkName xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 15</LinkName>
  <Links xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Href>
      <Rel>self</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>sample string 2</Href>
      <Rel>sample string 1</Rel>
      <Title>sample string 3</Title>
    </Link>
    <Link>
      <Href>sample string 2</Href>
      <Rel>sample string 1</Rel>
      <Title>sample string 3</Title>
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles</Href>
      <Rel>roles</Rel>
      <Title i:nil="true" />
    </Link>
    <Link>
      <Href>~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects</Href>
      <Rel>subjects</Rel>
      <Title i:nil="true" />
    </Link>
  </Links>
  <Rel xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 13</Rel>
  <Email>sample string 6</Email>
  <FirstName>sample string 4</FirstName>
  <Id>ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Id>
  <IdSource>3</IdSource>
  <InvitationCode>1ef07b2a-bfca-44e2-927e-1d411be181fe</InvitationCode>
  <JobRole>49e4da53-f3a7-4547-9452-eb8848bf7c95</JobRole>
  <JobTitle>sample string 11</JobTitle>
  <LastName>sample string 5</LastName>
  <LocalLogin>sample string 2</LocalLogin>
  <OrgId>653b866d-1c2c-4413-aeaf-00f89bcc1168</OrgId>
  <OrgMemberNumber>sample string 8</OrgMemberNumber>
  <StatusLabel>sample string 10</StatusLabel>
  <StatusValue>9</StatusValue>
  <Telephone>sample string 7</Telephone>
  <XrmContactId>ed947ded-ebf8-421a-b5f6-61db122e8280</XrmContactId>
</UserRepresentation>

application/hal+json

Sample:

{
  "Id": "ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1",
  "LocalLogin": "sample string 2",
  "IdSource": 3,
  "FirstName": "sample string 4",
  "LastName": "sample string 5",
  "Email": "sample string 6",
  "Telephone": "sample string 7",
  "OrgMemberNumber": "sample string 8",
  "OrgId": "653b866d-1c2c-4413-aeaf-00f89bcc1168",
  "StatusValue": 9,
  "StatusLabel": "sample string 10",
  "JobTitle": "sample string 11",
  "JobRole": "49e4da53-f3a7-4547-9452-eb8848bf7c95",
  "InvitationCode": "1ef07b2a-bfca-44e2-927e-1d411be181fe",
  "XrmContactId": "ed947ded-ebf8-421a-b5f6-61db122e8280",
  "_links": {
    "self": {
      "href": "/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1"
    },
    "sample string 1": {
      "href": "sample string 2",
      "title": "sample string 3"
    },
    "roles": {
      "href": "/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles"
    },
    "subjects": {
      "href": "/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects"
    }
  }
}

application/hal+xml

Sample:

<resource rel="sample string 13" href="~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1" name="sample string 15">
  <link rel="sample string 1" href="sample string 2" />
  <link rel="roles" href="~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/roles" />
  <link rel="subjects" href="~/users/ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1/subjects" />
  <Id>ca2698e2-0fb2-4f53-8fa4-20c0ce6a77d1</Id>
  <LocalLogin>sample string 2</LocalLogin>
  <IdSource>3</IdSource>
  <FirstName>sample string 4</FirstName>
  <LastName>sample string 5</LastName>
  <Email>sample string 6</Email>
  <Telephone>sample string 7</Telephone>
  <OrgMemberNumber>sample string 8</OrgMemberNumber>
  <OrgId>653b866d-1c2c-4413-aeaf-00f89bcc1168</OrgId>
  <StatusValue>9</StatusValue>
  <StatusLabel>sample string 10</StatusLabel>
  <JobTitle>sample string 11</JobTitle>
  <JobRole>49e4da53-f3a7-4547-9452-eb8848bf7c95</JobRole>
  <InvitationCode>1ef07b2a-bfca-44e2-927e-1d411be181fe</InvitationCode>
  <XrmContactId>ed947ded-ebf8-421a-b5f6-61db122e8280</XrmContactId>
</resource>