cURL
curl --request POST \
--url https://api.rownd.io/applications/{app}/groups/{group}/members \
--header 'Content-Type: application/json' \
--header 'x-rownd-app-key: <api-key>' \
--header 'x-rownd-app-secret: <api-key>' \
--data '
{
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
]
}
'import requests
url = "https://api.rownd.io/applications/{app}/groups/{group}/members"
payload = {
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": ["owner", "editor"]
}
headers = {
"x-rownd-app-key": "<api-key>",
"x-rownd-app-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-rownd-app-key': '<api-key>',
'x-rownd-app-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({user_id: 'user_fbylaq38591cghym5pabupj2', roles: ['owner', 'editor']})
};
fetch('https://api.rownd.io/applications/{app}/groups/{group}/members', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rownd.io/applications/{app}/groups/{group}/members",
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([
'user_id' => 'user_fbylaq38591cghym5pabupj2',
'roles' => [
'owner',
'editor'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-rownd-app-key: <api-key>",
"x-rownd-app-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.rownd.io/applications/{app}/groups/{group}/members"
payload := strings.NewReader("{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-rownd-app-key", "<api-key>")
req.Header.Add("x-rownd-app-secret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.rownd.io/applications/{app}/groups/{group}/members")
.header("x-rownd-app-key", "<api-key>")
.header("x-rownd-app-secret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rownd.io/applications/{app}/groups/{group}/members")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-rownd-app-key"] = '<api-key>'
request["x-rownd-app-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
],
"id": "member_dnn5g4e3q6aptail2gr43kpj",
"state": "active",
"invited_by": "<string>",
"added_by": "<string>",
"profile": {
"user_id": "user_a7b53gwdaml5jt7t71442nt7",
"email": "gary@foo.com",
"first_name": "Gary",
"last_name": "Jackson"
},
"group_id": "group_ig42thhwf4cig25o7t9jtlyu"
}Group Members
Create a group member
Platform API for creating a member within the group. You can create a member by providing a user
ID or a user lookup value like an email address or phone number. The first member created within
a group will automatically be assigned the 'owner' role.
POST
/
applications
/
{app}
/
groups
/
{group}
/
members
cURL
curl --request POST \
--url https://api.rownd.io/applications/{app}/groups/{group}/members \
--header 'Content-Type: application/json' \
--header 'x-rownd-app-key: <api-key>' \
--header 'x-rownd-app-secret: <api-key>' \
--data '
{
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
]
}
'import requests
url = "https://api.rownd.io/applications/{app}/groups/{group}/members"
payload = {
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": ["owner", "editor"]
}
headers = {
"x-rownd-app-key": "<api-key>",
"x-rownd-app-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-rownd-app-key': '<api-key>',
'x-rownd-app-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({user_id: 'user_fbylaq38591cghym5pabupj2', roles: ['owner', 'editor']})
};
fetch('https://api.rownd.io/applications/{app}/groups/{group}/members', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rownd.io/applications/{app}/groups/{group}/members",
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([
'user_id' => 'user_fbylaq38591cghym5pabupj2',
'roles' => [
'owner',
'editor'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-rownd-app-key: <api-key>",
"x-rownd-app-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.rownd.io/applications/{app}/groups/{group}/members"
payload := strings.NewReader("{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-rownd-app-key", "<api-key>")
req.Header.Add("x-rownd-app-secret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.rownd.io/applications/{app}/groups/{group}/members")
.header("x-rownd-app-key", "<api-key>")
.header("x-rownd-app-secret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rownd.io/applications/{app}/groups/{group}/members")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-rownd-app-key"] = '<api-key>'
request["x-rownd-app-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_id\": \"user_fbylaq38591cghym5pabupj2\",\n \"roles\": [\n \"owner\",\n \"editor\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
],
"id": "member_dnn5g4e3q6aptail2gr43kpj",
"state": "active",
"invited_by": "<string>",
"added_by": "<string>",
"profile": {
"user_id": "user_a7b53gwdaml5jt7t71442nt7",
"email": "gary@foo.com",
"first_name": "Gary",
"last_name": "Jackson"
},
"group_id": "group_ig42thhwf4cig25o7t9jtlyu"
}Authorizations
appKey & appSecrethubAccessTokenForRowndApi
The publishable key of your application credentials. (more details)
The private secret of your application credentials. (more details)
Body
application/json
The ID of a user to add as a group member. The user must belong to the Rownd application.
Example:
"user_fbylaq38591cghym5pabupj2"
The roles that the member belongs. (The first member added or invited to a group will always be created with the 'owner' role along with any additional roles specified)
Example:
["owner", "editor"]
The state of the group member. A member that has been invited will not go into the active
state until they accept the invitation.
Available options:
active, invite_pending, invite_rejected Response
200 - application/json
Group member created successfully
The ID of a user to add as a group member. The user must belong to the Rownd application.
Example:
"user_fbylaq38591cghym5pabupj2"
The roles that the member belongs. (The first member added or invited to a group will always be created with the 'owner' role along with any additional roles specified)
Example:
["owner", "editor"]
The group member ID
Example:
"member_dnn5g4e3q6aptail2gr43kpj"
The state of the group member. A member that has been invited will not go into the active
state until they accept the invitation.
Available options:
active, invite_pending, invite_rejected The authenticated party that invited the user to the group
The authenticated party that added the user to the gruop
User profile data
Example:
{
"user_id": "user_a7b53gwdaml5jt7t71442nt7",
"email": "gary@foo.com",
"first_name": "Gary",
"last_name": "Jackson"
}
The group ID
Example:
"group_ig42thhwf4cig25o7t9jtlyu"