cURL
curl --request POST \
--url https://api.recoupable.dev/api/organizations/domains \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com"
}
'import requests
url = "https://api.recoupable.dev/api/organizations/domains"
payload = {
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
organizationId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
domain: 'seekermusic.com'
})
};
fetch('https://api.recoupable.dev/api/organizations/domains', 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.recoupable.dev/api/organizations/domains",
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([
'organizationId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'domain' => 'seekermusic.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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.recoupable.dev/api/organizations/domains"
payload := strings.NewReader("{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.recoupable.dev/api/organizations/domains")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/organizations/domains")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}Organizations
Add Organization Domain
Map an email domain to an organization for automatic membership. After mapping, any account that signs up (or signs in) with an email at this domain is automatically added to the organization. A domain can belong to at most one organization. This endpoint is idempotent - re-adding the same domain to the same organization returns the existing mapping.
POST
/
api
/
organizations
/
domains
cURL
curl --request POST \
--url https://api.recoupable.dev/api/organizations/domains \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com"
}
'import requests
url = "https://api.recoupable.dev/api/organizations/domains"
payload = {
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
organizationId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
domain: 'seekermusic.com'
})
};
fetch('https://api.recoupable.dev/api/organizations/domains', 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.recoupable.dev/api/organizations/domains",
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([
'organizationId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'domain' => 'seekermusic.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <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.recoupable.dev/api/organizations/domains"
payload := strings.NewReader("{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<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.recoupable.dev/api/organizations/domains")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/organizations/domains")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"organizationId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"domain\": \"seekermusic.com\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "seekermusic.com",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}{
"status": "error",
"error": "<string>"
}Authorizations
apiKeyAuthbearerAuth
Your Recoup API key. Learn more.
Body
application/json
Domain-organization mapping parameters
Response
Domain mapped to organization successfully (or already mapped)
Was this page helpful?
⌘I
