Create a recipient
curl --request POST \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"recipient": {
"name": "Tim Bradford",
"email": "tim@example.com"
},
"email": "oliver@example.com"
}
'import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients"
payload = {
"recipient": {
"name": "Tim Bradford",
"email": "tim@example.com"
},
"email": "oliver@example.com"
}
headers = {
"X-Api-Key": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
recipient: {name: 'Tim Bradford', email: 'tim@example.com'},
email: 'oliver@example.com'
})
};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients', 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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients",
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([
'recipient' => [
'name' => 'Tim Bradford',
'email' => 'tim@example.com'
],
'email' => 'oliver@example.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients"
payload := strings.NewReader("{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients")
.header("X-Api-Key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"notice_code": "<string>"
}Recipients (v1)
Create recipient
Create a recipient.
POST
/
clients
/
{client_id}
/
recipients
Create a recipient
curl --request POST \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"recipient": {
"name": "Tim Bradford",
"email": "tim@example.com"
},
"email": "oliver@example.com"
}
'import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients"
payload = {
"recipient": {
"name": "Tim Bradford",
"email": "tim@example.com"
},
"email": "oliver@example.com"
}
headers = {
"X-Api-Key": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
recipient: {name: 'Tim Bradford', email: 'tim@example.com'},
email: 'oliver@example.com'
})
};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients', 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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients",
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([
'recipient' => [
'name' => 'Tim Bradford',
'email' => 'tim@example.com'
],
'email' => 'oliver@example.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients"
payload := strings.NewReader("{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-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://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients")
.header("X-Api-Key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{your-subdomain}.neetoinvoice.com/api/external/v1/clients/{client_id}/recipients")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"recipient\": {\n \"name\": \"Tim Bradford\",\n \"email\": \"tim@example.com\"\n },\n \"email\": \"oliver@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"notice_code": "<string>"
}Deprecated: This is a v1 endpoint and is deprecated. Please use the
v2 API instead. v1 endpoints will be removed
in a future release.
Replace
Learn how to find your subdomain in Workspace subdomain.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Path Parameters
Unique ID of the client for which you want to retrieve or update details. Refer to Getting the Client ID section for detailed instructions.
Body
application/json
Response
200 - application/json
OK - Request succeeded
⌘I