Create Artist

cURL

curl --request POST \
  --url https://recoup-api.vercel.app/api/artists \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://recoup-api.vercel.app/api/artists"

payload = {
    "name": "<string>",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
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({
    name: '<string>',
    account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    organization_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://recoup-api.vercel.app/api/artists', 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://recoup-api.vercel.app/api/artists",
  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([
    'name' => '<string>',
    'account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'organization_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  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://recoup-api.vercel.app/api/artists"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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://recoup-api.vercel.app/api/artists")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://recoup-api.vercel.app/api/artists")

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  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"

response = http.request(request)
puts response.read_body

{
  "artist": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "image": "<string>",
    "instruction": "<string>",
    "knowledges": [
      "<string>"
    ],
    "label": "<string>",
    "organization": "<string>",
    "company_name": "<string>",
    "job_title": "<string>",
    "role_type": "<string>",
    "onboarding_status": "<string>",
    "onboarding_data": "<unknown>",
    "account_info": "<array>",
    "account_socials": "<array>"
  }
}

{
  "status": "error",
  "missing_fields": [
    "<string>"
  ],
  "error": "<string>",
  "message": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

POST

api

artists

cURL

curl --request POST \
  --url https://recoup-api.vercel.app/api/artists \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://recoup-api.vercel.app/api/artists"

payload = {
    "name": "<string>",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
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({
    name: '<string>',
    account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    organization_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://recoup-api.vercel.app/api/artists', 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://recoup-api.vercel.app/api/artists",
  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([
    'name' => '<string>',
    'account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'organization_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  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://recoup-api.vercel.app/api/artists"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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://recoup-api.vercel.app/api/artists")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://recoup-api.vercel.app/api/artists")

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  \"name\": \"<string>\",\n  \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"organization_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"

response = http.request(request)
puts response.read_body

{
  "artist": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "image": "<string>",
    "instruction": "<string>",
    "knowledges": [
      "<string>"
    ],
    "label": "<string>",
    "organization": "<string>",
    "company_name": "<string>",
    "job_title": "<string>",
    "role_type": "<string>",
    "onboarding_status": "<string>",
    "onboarding_data": "<unknown>",
    "account_info": "<array>",
    "account_socials": "<array>"
  }
}

{
  "status": "error",
  "missing_fields": [
    "<string>"
  ],
  "error": "<string>",
  "message": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

Authorizations

x-api-key

string

header

required

Your Recoup API key. Learn more.

Body

application/json

Artist creation parameters

name

string

required

The name of the artist to create

Minimum string length: 1

account_id

string<uuid>

UUID of the account to create the artist for. Only applicable for organization API keys - org keys can specify an account_id for any account within their organization. If not provided, the artist is created for the API key's own account.

organization_id

string<uuid>

Optional organization ID to link the new artist to

Response

Artist created successfully

artist

object

required

Show child attributes

Get Artists Get Artist Segments

API documentation

Chat

Tasks

Accounts

Artists

Segment

Fans

Posts

Post

Comments

Organizations

Spotify

Instagram

X (Twitter)

Social

Image

Transcribe

Songs & Catalogs

Subscriptions

Apify

Authorizations

Body

Response