Create a new user from person.

POST

/customer-api/v1/persons/create-user

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://your-instance.seventhings.com/customer-api/v1/persons/create-user");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }");

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://your-instance.seventhings.com/customer-api/v1/persons/create-user"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://your-instance.seventhings.com/customer-api/v1/persons/create-user"

  payload := strings.NewReader("{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://your-instance.seventhings.com/customer-api/v1/persons/create-user"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }");
Request request = new Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/persons/create-user")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://your-instance.seventhings.com/customer-api/v1/persons/create-user',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  data: {filter: {'<filter_id>': '<filter_name>'}}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://your-instance.seventhings.com/customer-api/v1/persons/create-user';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"filter":{"<filter_id>":"<filter_name>"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }")
val request = Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/persons/create-user")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-instance.seventhings.com/customer-api/v1/persons/create-user",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filter' => [
        '<filter_id>' => '<filter_name>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://your-instance.seventhings.com/customer-api/v1/persons/create-user', [
  'body' => '{ "filter": { "<filter_id>": "<filter_name>" } }',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

import http.client

conn = http.client.HTTPSConnection("your-instance.seventhings.com")

payload = "{ \"filter\": { \"<filter_id>\": \"<filter_name>\" } }"

headers = {
    'Authorization': "Bearer <token>",
    'Content-Type': "application/json"
}

conn.request("POST", "/customer-api/v1/persons/create-user", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

import requests

url = "https://your-instance.seventhings.com/customer-api/v1/persons/create-user"

payload = { "filter": { "<filter_id>": "<filter_name>" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://your-instance.seventhings.com/customer-api/v1/persons/create-user";

    let payload = json!({"filter": json!({"<filter_id>": "<filter_name>"})});

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request POST \
  --url https://your-instance.seventhings.com/customer-api/v1/persons/create-user \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "<filter_id>": "<filter_name>" } }'

wget --quiet \
  --method POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body-data '{ "filter": { "<filter_id>": "<filter_name>" } }' \
  --output-document \
  - https://your-instance.seventhings.com/customer-api/v1/persons/create-user

Create a new user from person.

Authorizations

bearerAuth

Request Body^required

application/json

object

filter

The filter to find the person to create user from. Have a look at the field definition to find a unique attribute for this filter. All found persons will be used to create users, so make sure to use a filter that only finds one person. You can check the filter against person list endpoint to see how many persons will be found by the filter.

The created user will receive an email if successful.

object

key

additional properties

any

Example

{
  "<filter_id>": "<filter_name>"
}

Responses

201

Success

400

Request body is missing or invalid or request data is invalid.

401

Access token is missing or invalid.

403

You are not permitted to perform the requested operation.

404

The requested resource could not be found.

406

The requested resource representation has no acceptable format.

500

Internal Server Error.

Create a new user from person.

Authorizations

Request Bodyrequired

Example

Responses

201

400

401

403

404

406

500

Request Body^required