$ch = curl_init();
$data = [
    'portal_name'         => 'Portal Name here',
    'contact_email'       => 'contact@example.com',
    'contact_name'        => 'Contact Name here',
    'variables[0][name]'  => 'address',
    'variables[0][value]' => 'delhi',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const form = new URLSearchParams();
form.append('portal_name', 'Portal Name');
form.append('contact_email', 'contact@example.com');
form.append('contact_name', 'Contact Name');
form.append('variables[0][name]', 'address');
form.append('variables[0][value]', 'delhi');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_name':         'Portal Name',
        'contact_email':       'contact@example.com',
        'contact_name':        'Contact Name',
        'variables[0][name]':  'address',
        'variables[0][value]': 'delhi',
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_name\":[\"The portal name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

$params = http_build_query([
    'search' => 'Acme',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ search: 'Acme', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/list',
    params={'search': 'Acme', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"limit\":[\"The limit may not be greater than 100.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4' });
const res = await fetch(`https://ahsuite.com/api/portal/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/detail',
    params={'portal_id': 'vJW4'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/share-link?portal_id=vJW4');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/share-link?portal_id=vJW4', {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/share-link',
    params={'portal_id': 'vJW4'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/share-link/generate');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['portal_id' => 'vJW4']));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/share-link/generate', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/share-link/generate',
    data={'portal_id': 'vJW4'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [ 'portal_id' => 'PORTAL_ID', 'name' => 'Conversation Name' ];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/conversation/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const url = new URL('https://ahsuite.com/api/portal/conversation/create');
url.searchParams.set('portal_id', 'PORTAL_ID');
url.searchParams.set('name', 'Conversation Name');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/conversation/create',
    auth=('EMAIL', 'TOKEN'),
    params={'portal_id': 'PORTAL_ID', 'name': 'Conversation Name'},
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/conversation/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/conversation/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/conversation/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'conversation_id' => 271,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/conversation/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', conversation_id: 271 });
const res = await fetch(`https://ahsuite.com/api/portal/conversation/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/conversation/detail',
    params={'portal_id': 'vJW4', 'conversation_id': 271},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"conversation_id\":[\"The conversation id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Conversation record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'conversation_id' => 276,
    'message' => 'Thanks, reviewing this now.',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/conversation/reply');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', conversation_id: '276', message: 'Thanks, reviewing this now.' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/conversation/reply', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/conversation/reply',
    data={'portal_id': 'vJW4', 'conversation_id': 276, 'message': 'Thanks, reviewing this now.'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "This Conversation is maxed out! You'll need to create a new Conversation to continue the discussion."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Conversation record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'conversation_id' => 276,
    'name' => 'Q3 planning',
    'email_not_send' => 0,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/conversation/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', conversation_id: '276', name: 'Q3 planning', email_not_send: '0' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/conversation/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/conversation/update',
    data={'portal_id': 'vJW4', 'conversation_id': 276, 'name': 'Q3 planning', 'email_not_send': 0},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "This setting cannot be changed for a HIPAA compliant client."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Conversation record not found."
}

$ch = curl_init();
$data = [
    'portal_id'       => 'PORTAL_ID',
    'title'           => 'Page Title',
    'text[content]'   => 'Welcome to your new page.',
    'text[heading]'   => 'Getting Started',
    'code[content]'   => '<div><h3>Hello</h3></div>',
    'embed[url]'      => 'https://docs.google.com/document/d/XXXX',
    'video[url]'      => 'https://www.youtube.com/watch?v=XXXX',
    'image[file]'     => new CURLFile('/path/to/photo.jpg'),
    'files[0][file]'  => new CURLFile('/path/to/brief.pdf'),
    'files[0][file_name]' => 'Project Brief',
    'files[1][title]' => 'Signed contract',
    'questions[0][question_name]' => 'What is your main business goal?',
    'questions[1][question_type]' => 'multiple_choice',
    'questions[1][question_name]' => 'Preferred contact method?',
    'questions[1][options][0]' => 'Email',
    'questions[1][options][1]' => 'Phone',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // array = multipart/form-data (required for image[file])
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';
import FormData from 'form-data';
import fs from 'fs';

const form = new FormData();
form.append('portal_id', 'PORTAL_ID');
form.append('title', 'Page Title');
form.append('text[content]', 'Welcome to your new page.');
form.append('text[heading]', 'Getting Started');
form.append('code[content]', '<div><h3>Hello</h3></div>');
form.append('embed[url]', 'https://docs.google.com/document/d/XXXX');
form.append('video[url]', 'https://www.youtube.com/watch?v=XXXX');
form.append('image[file]', fs.createReadStream('/path/to/photo.jpg'));
form.append('files[0][file]', fs.createReadStream('/path/to/brief.pdf'));
form.append('files[0][file_name]', 'Project Brief');
form.append('files[1][title]', 'Signed contract');
form.append('questions[0][question_name]', 'What is your main business goal?');
form.append('questions[1][question_type]', 'multiple_choice');
form.append('questions[1][question_name]', 'Preferred contact method?');
form.append('questions[1][options][]', 'Email');
form.append('questions[1][options][]', 'Phone');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id':       'PORTAL_ID',
        'title':           'Page Title',
        'text[content]':   'Welcome to your new page.',
        'text[heading]':   'Getting Started',
        'code[content]':   '<div><h3>Hello</h3></div>',
        'embed[url]':      'https://docs.google.com/document/d/XXXX',
        'video[url]':      'https://www.youtube.com/watch?v=XXXX',
        'files[0][file_name]': 'Project Brief',
        'files[1][title]': 'Signed contract',
        'questions[0][question_name]': 'What is your main business goal?',
        'questions[1][question_type]': 'multiple_choice',
        'questions[1][question_name]': 'Preferred contact method?',
        'questions[1][options][0]': 'Email',
        'questions[1][options][1]': 'Phone',
    },
    files={
        'image[file]': open('/path/to/photo.jpg', 'rb'),
        'files[0][file]': open('/path/to/brief.pdf', 'rb'),
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"title\":[\"The title field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/page/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/page/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page_id: '9dRt' });
const res = await fetch(`https://ahsuite.com/api/portal/page/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/page/detail',
    params={'portal_id': 'vJW4', 'page_id': '9dRt'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"page_id\":[\"The page id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Page record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
    'title' => 'Monthly SEO Report (June)',
    'tab_id' => '3xQb',
    'embed' => ['url' => 'https://docs.google.com/spreadsheets/d/1AbC/edit', 'height' => 800],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'vJW4',
  page_id: '9dRt',
  title: 'Monthly SEO Report (June)',
  tab_id: '3xQb',
  'embed[url]': 'https://docs.google.com/spreadsheets/d/1AbC/edit',
  'embed[height]': '800',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/update',
    data={
        'portal_id': 'vJW4',
        'page_id': '9dRt',
        'title': 'Monthly SEO Report (June)',
        'tab_id': '3xQb',
        'embed[url]': 'https://docs.google.com/spreadsheets/d/1AbC/edit',
        'embed[height]': 800,
    },
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "tab_id is required when sending content blocks (get it from page/detail)."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Tab record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
    'title' => 'Resources',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/tab/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', page_id: '9dRt', title: 'Resources' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/tab/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/tab/add',
    data={'portal_id': 'vJW4', 'page_id': '9dRt', 'title': 'Resources'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Maximum 20 tabs can be added."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Page record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
    'question_id' => '5wA2',
    'question_name' => 'Preferred contact method',
    'required' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/question/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'vJW4',
  page_id: '9dRt',
  question_id: '5wA2',
  question_name: 'Preferred contact method',
  required: '1',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/question/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/question/update',
    data={'portal_id': 'vJW4', 'page_id': '9dRt', 'question_id': '5wA2', 'question_name': 'Preferred contact method', 'required': 1},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Question record not found on this page."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
    'question_id' => '5wA2',
    'section_id' => '5wA3',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/question/move');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', page_id: '9dRt', question_id: '5wA2', section_id: '5wA3' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/question/move', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/question/move',
    data={'portal_id': 'vJW4', 'page_id': '9dRt', 'question_id': '5wA2', 'section_id': '5wA3'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "A section cannot be moved inside another section."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Section record not found on the same tab as the question."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'page_id' => '9dRt',
    'question_id' => '5wA2',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/page/question/delete');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', page_id: '9dRt', question_id: '5wA2' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/page/question/delete', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/page/question/delete',
    data={'portal_id': 'vJW4', 'page_id': '9dRt', 'question_id': '5wA2'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"question_id\":[\"The question id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Question record not found on this page."
}

$ch = curl_init();
$data = [
    'portal_id'        => 'PORTAL_ID',
    'name'             => 'Follow up with the client',
    'description'      => 'Call to review the latest deliverables.',
    'due_date'         => '2026-08-01',
    'assign_to_client' => 0,
    'checklist[0]'     => 'Draft the report',
    'checklist[1]'     => 'Send for review',
    'labels[0][name]'  => 'Priority',
    'labels[0][color]' => 'red',
    'attachments[0]'   => new CURLFile('/path/to/spec.pdf'),
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // array = multipart/form-data (required for attachments[])
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';
import FormData from 'form-data';
import fs from 'fs';

const form = new FormData();
form.append('portal_id', 'PORTAL_ID');
form.append('name', 'Follow up with the client');
form.append('description', 'Call to review the latest deliverables.');
form.append('due_date', '2026-08-01');
form.append('assign_to_client', '0');
form.append('checklist[]', 'Draft the report');
form.append('checklist[]', 'Send for review');
form.append('labels[0][name]', 'Priority');
form.append('labels[0][color]', 'red');
form.append('attachments[]', fs.createReadStream('/path/to/spec.pdf'));

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id':      'PORTAL_ID',
        'name':           'Follow up with the client',
        'description':    'Call to review the latest deliverables.',
        'due_date':       '2026-08-01',
        'assign_to_client': 0,
        'checklist[]':      ['Draft the report', 'Send for review'],
        'labels[0][name]':  'Priority',
        'labels[0][color]': 'red',
    },
    files={'attachments[]': open('/path/to/spec.pdf', 'rb')},
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'status' => 'in_progress',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', status: 'in_progress', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/task/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/task/list',
    params={'portal_id': 'vJW4', 'status': 'in_progress', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"status\":[\"The selected status is invalid.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'task_id' => 3659,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', task_id: '3659' });
const res = await fetch(`https://ahsuite.com/api/portal/task/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/task/detail',
    params={'portal_id': 'vJW4', 'task_id': 3659},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"task_id\":[\"The task id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'name' => 'Send the June report',
    'due_date' => '2026-06-30',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'vJW4',
  task_id: '3659',
  name: 'Send the June report',
  due_date: '2026-06-30',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/update',
    data={'portal_id': 'vJW4', 'task_id': 3659, 'name': 'Send the June report', 'due_date': '2026-06-30'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'assign_to' => 'client_user',
    'email' => 'jane@example.com',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/assign');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', task_id: '3659', assign_to: 'client_user', email: 'jane@example.com' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/assign', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/assign',
    data={'portal_id': 'vJW4', 'task_id': 3659, 'assign_to': 'client_user', 'email': 'jane@example.com'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Not allowed to remove client from assignee"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "No active client user with this email in this portal."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'labels' => [
        ['name' => 'Reporting', 'color' => 'blue'],
        ['name' => 'Urgent', 'color' => 'red'],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/label/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'vJW4',
  task_id: '3659',
  'labels[0][name]': 'Reporting',
  'labels[0][color]': 'blue',
  'labels[1][name]': 'Urgent',
  'labels[1][color]': 'red',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/label/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/label/add',
    data={
        'portal_id': 'vJW4',
        'task_id': 3659,
        'labels[0][name]': 'Reporting', 'labels[0][color]': 'blue',
        'labels[1][name]': 'Urgent', 'labels[1][color]': 'red',
    },
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "These labels are already on the task — nothing to change."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'checklist' => ['Export analytics', 'Write summary'],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/checklist/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('task_id', '3659');
body.append('checklist[]', 'Export analytics');
body.append('checklist[]', 'Write summary');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/checklist/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/checklist/add',
    data={'portal_id': 'vJW4', 'task_id': 3659, 'checklist[]': ['Export analytics', 'Write summary']},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Item name is blank."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'item_id' => 8101,
    'completed' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/checklist/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', task_id: '3659', item_id: '8101', completed: '1' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/checklist/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/checklist/update',
    data={'portal_id': 'vJW4', 'task_id': 3659, 'item_id': 8101, 'completed': 1},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Checklist item not found on this task."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'attachment' => new CURLFile('/path/to/brief.pdf'),
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/attachment/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';
import { FormData, File } from 'node-fetch';
import { readFileSync } from 'fs';

const form = new FormData();
form.append('portal_id', 'vJW4');
form.append('task_id', '3659');
form.append('attachment', new File([readFileSync('/path/to/brief.pdf')], 'brief.pdf'));

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/attachment/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/attachment/add',
    data={'portal_id': 'vJW4', 'task_id': 3659},
    files={'attachment': open('/path/to/brief.pdf', 'rb')},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Total task attachments adding limit is 70."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'task_id' => 3659,
    'comment' => 'Draft is ready for review.',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/task/comment/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', task_id: '3659', comment: 'Draft is ready for review.' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/task/comment/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/task/comment/add',
    data={'portal_id': 'vJW4', 'task_id': 3659, 'comment': 'Draft is ready for review.'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"comment\":[\"The comment field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found."
}

$ch = curl_init();
$data = [
    'portal_id'                        => 'PORTAL_ID',
    'upload[file]'                     => new CURLFile('/path/to/contract.pdf'),
    'upload[require_client_approval]'  => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // array = multipart/form-data (required for upload[file])
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';
import FormData from 'form-data';
import fs from 'fs';

const form = new FormData();
form.append('portal_id', 'PORTAL_ID');
form.append('upload[file]', fs.createReadStream('/path/to/contract.pdf'));
form.append('upload[require_client_approval]', '1');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id':                       'PORTAL_ID',
        'upload[require_client_approval]': 1,
    },
    files={'upload[file]': open('/path/to/contract.pdf', 'rb')},
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Send exactly one of: file, link[url], request[title] or folder[title]."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/file/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/file/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Folder record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', file_id: '7pQ1' });
const res = await fetch(`https://ahsuite.com/api/portal/file/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/file/detail',
    params={'portal_id': 'vJW4', 'file_id': '7pQ1'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"file_id\":[\"The file id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "File record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
    'title' => 'Signed contract (final)',
    'require_client_approval' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', file_id: '7pQ1', title: 'Signed contract (final)', require_client_approval: '1' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/update',
    data={'portal_id': 'vJW4', 'file_id': '7pQ1', 'title': 'Signed contract (final)', 'require_client_approval': 1},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Oop's this document is already approved!!"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "File record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
    'attachment_file' => new CURLFile('/path/to/contract-v3.pdf'),
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/version/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

// link version — for an upload use FormData with an 'attachment_file' file instead
const body = new URLSearchParams({ portal_id: 'vJW4', file_id: '7pQ1', url: 'https://drive.google.com/file/d/1AbC/view' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/version/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/version/add',
    data={'portal_id': 'vJW4', 'file_id': '7pQ1'},
    files={'attachment_file': open('/path/to/contract-v3.pdf', 'rb')},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Send exactly one of: attachment_file (file) or url."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "File record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
    'comment' => 'Please sign page 3 as well.',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/comment/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', file_id: '7pQ1', comment: 'Please sign page 3 as well.' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/comment/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/comment/add',
    data={'portal_id': 'vJW4', 'file_id': '7pQ1', 'comment': 'Please sign page 3 as well.'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Comments cannot be added to a folder."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "File record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
    'folder_id' => '6kFz',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/move');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', file_id: '7pQ1', folder_id: '6kFz' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/move', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/move',
    data={'portal_id': 'vJW4', 'file_id': '7pQ1', 'folder_id': '6kFz'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Can be moved in a folder only."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Folder record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'file_id' => '7pQ1',
    'labels' => [
        ['name' => 'Legal', 'color' => 'purple'],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/file/label/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'vJW4',
  file_id: '7pQ1',
  'labels[0][name]': 'Legal',
  'labels[0][color]': 'purple',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/file/label/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/file/label/add',
    data={'portal_id': 'vJW4', 'file_id': '7pQ1', 'labels[0][name]': 'Legal', 'labels[0][color]': 'purple'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "These labels are already on the file — nothing to change."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "File record not found."
}

$ch = curl_init();
$data = [ 'portal_id' => 'PORTAL_ID', 'name' => 'Journal Name' ];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/journal/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const url = new URL('https://ahsuite.com/api/portal/journal/create');
url.searchParams.set('portal_id', 'PORTAL_ID');
url.searchParams.set('name', 'Journal Name');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/journal/create',
    auth=('EMAIL', 'TOKEN'),
    params={'portal_id': 'PORTAL_ID', 'name': 'Journal Name'},
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/journal/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/journal/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/journal/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'journal_id' => 60,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/journal/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', journal_id: '60' });
const res = await fetch(`https://ahsuite.com/api/portal/journal/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/journal/detail',
    params={'portal_id': 'vJW4', 'journal_id': 60},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"journal_id\":[\"The journal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Journal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'journal_id' => 60,
    'name' => 'Website redesign v2',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/journal/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('journal_id', '60');
body.append('name', 'Website redesign v2');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/journal/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/journal/update',
    data={'portal_id': 'vJW4', 'journal_id': 60, 'name': 'Website redesign v2'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Journal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'journal_id' => 60,
    'log' => 'Kickoff call done, notes shared with @jane.',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/journal/log/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('journal_id', '60');
body.append('log', 'Kickoff call done, notes shared with @jane.');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/journal/log/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/journal/log/add',
    data={'portal_id': 'vJW4', 'journal_id': 60, 'log': 'Kickoff call done, notes shared with @jane.'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"log\":[\"The log field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Journal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'name'      => 'Hosting cPanel',
    'url'       => 'https://example.com/login',
    'username'  => 'admin',
    'share_with_client' => 0,
    'request'   => [
        'client_user_email' => 'sam@client.com',
        'message'           => 'Please add the cPanel password here.',
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/password/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  name: 'Hosting cPanel',
  url: 'https://example.com/login',
  username: 'admin',
  share_with_client: '0',
  'request[client_user_email]': 'sam@client.com',
  'request[message]': 'Please add the cPanel password here.',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/password/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/password/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'name':      'Hosting cPanel',
        'url':       'https://example.com/login',
        'username':  'admin',
        'share_with_client': 0,
        'request[client_user_email]': 'sam@client.com',
        'request[message]': 'Please add the cPanel password here.',
    },
)
print(res.json())

// a password was sent — nothing is saved
{
  "success": false,
  "message": "Validation Error",
  "data": "Passwords can't go through the assistant, so nothing was saved. Save the login without its password; the user then adds the password in Ahsuite. If the user typed a password in this chat, tell them it is now in the chat history."
}

// other refusals
{ "success": false, "message": "Validation Error", "data": "That person isn't a client user of this portal." }
{ "success": false, "message": "Validation Error", "data": "This portal has sent 20 password requests today. Try again tomorrow." }
{ "success": false, "message": "Validation Error", "data": "Send either request or generate, not both." }
{ "success": false, "message": "Validation Error", "data": "{\"name\":[\"The name field is required.\"]}" }

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/password/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/password/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/password/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id'    => 'PORTAL_ID',
    'invoice_date' => '2026-07-08',
    'due_date'     => '2026-07-22',
    'items' => [
        [
            'name'     => 'Website design',
            'quantity' => 1,
            'price'    => 500,
            'sub_items' => [
                [ 'type' => 'add', 'description' => 'VAT 20%', 'amount' => 100 ],
            ],
        ],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  invoice_date: '2026-07-08',
  due_date: '2026-07-22',
  'items[0][name]': 'Website design',
  'items[0][quantity]': '1',
  'items[0][price]': '500',
  'items[0][sub_items][0][type]': 'add',
  'items[0][sub_items][0][description]': 'VAT 20%',
  'items[0][sub_items][0][amount]': '100',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id':    'PORTAL_ID',
        'invoice_date': '2026-07-08',
        'due_date':     '2026-07-22',
        'items[0][name]':     'Website design',
        'items[0][quantity]': 1,
        'items[0][price]':    500,
        'items[0][sub_items][0][type]':        'add',
        'items[0][sub_items][0][description]': 'VAT 20%',
        'items[0][sub_items][0][amount]':      100,
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Invoice number 00006 already exists for this portal. Please use a different number."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/invoice/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/invoice/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'invoice_id' => 55,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', invoice_id: '55' });
const res = await fetch(`https://ahsuite.com/api/portal/invoice/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/invoice/detail',
    params={'portal_id': 'vJW4', 'invoice_id': 55},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"invoice_id\":[\"The invoice id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Invoice record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'invoice_id' => 55,
    'due_date' => '2026-10-30',
    'notes' => 'Payable within 30 days.',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');
body.append('due_date', '2026-10-30');
body.append('notes', 'Payable within 30 days.');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/update',
    data={'portal_id': 'vJW4', 'invoice_id': 55, 'due_date': '2026-10-30', 'notes': 'Payable within 30 days.'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Only unpaid invoices can be edited."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Invoice record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'invoice_id' => 55,
    'name' => 'Logo design',
    'quantity' => 1,
    'price' => 300,
    'sub_items' => [['type' => 'subtract', 'description' => 'Loyalty discount', 'amount' => 50]],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/item/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');
body.append('name', 'Logo design');
body.append('quantity', '1');
body.append('price', '300');
body.append('sub_items[0][type]', 'subtract');
body.append('sub_items[0][description]', 'Loyalty discount');
body.append('sub_items[0][amount]', '50');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/item/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/item/add',
    data={
        'portal_id': 'vJW4', 'invoice_id': 55, 'name': 'Logo design', 'quantity': 1, 'price': 300,
        'sub_items[0][type]': 'subtract', 'sub_items[0][description]': 'Loyalty discount', 'sub_items[0][amount]': 50,
    },
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Only unpaid invoices can be edited."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Invoice record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'invoice_id' => 55,
    'item_id' => 912,
    'quantity' => 2,
    'sub_items' => [
        ['sub_item_id' => 3301, 'amount' => 75],
        ['type' => 'add', 'description' => 'Rush delivery', 'amount' => 100],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/item/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');
body.append('item_id', '912');
body.append('quantity', '2');
body.append('sub_items[0][sub_item_id]', '3301');
body.append('sub_items[0][amount]', '75');
body.append('sub_items[1][type]', 'add');
body.append('sub_items[1][description]', 'Rush delivery');
body.append('sub_items[1][amount]', '100');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/item/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/item/update',
    data={
        'portal_id': 'vJW4', 'invoice_id': 55, 'item_id': 912, 'quantity': 2,
        'sub_items[0][sub_item_id]': 3301, 'sub_items[0][amount]': 75,
        'sub_items[1][type]': 'add', 'sub_items[1][description]': 'Rush delivery', 'sub_items[1][amount]': 100,
    },
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Nothing to update. Send at least one of: name, description, quantity, price, sub_items."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Item not found on this invoice."
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/item/remove');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['portal_id' => 'vJW4', 'invoice_id' => 55, 'item_id' => 912]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');
body.append('item_id', '912');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/item/remove', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/item/remove',
    data={'portal_id': 'vJW4', 'invoice_id': 55, 'item_id': 912},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Only unpaid invoices can be edited."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Item not found on this invoice."
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/item/adjustment/remove');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['portal_id' => 'vJW4', 'invoice_id' => 55, 'item_id' => 912, 'sub_item_id' => 3301]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');
body.append('item_id', '912');
body.append('sub_item_id', '3301');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/item/adjustment/remove', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/item/adjustment/remove',
    data={'portal_id': 'vJW4', 'invoice_id': 55, 'item_id': 912, 'sub_item_id': 3301},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Only unpaid invoices can be edited."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Adjustment not found on this item."
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/invoice/mark-paid');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['portal_id' => 'vJW4', 'invoice_id' => 55]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('invoice_id', '55');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/invoice/mark-paid', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/invoice/mark-paid',
    data={'portal_id': 'vJW4', 'invoice_id': 55},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "This invoice is already paid."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Invoice record not found."
}

$ch = curl_init();
$data = [
    'portal_id'   => 'PORTAL_ID',
    'name'        => 'Website Redesign',
    'description' => 'Full redesign of the marketing site',
    'share_with_client' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  name: 'Website Redesign',
  description: 'Full redesign of the marketing site',
  share_with_client: '1',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id':   'PORTAL_ID',
        'name':        'Website Redesign',
        'description': 'Full redesign of the marketing site',
        'share_with_client': 1,
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/project/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/project/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'project_id' => 328,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/detail?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', project_id: '328' });
const res = await fetch(`https://ahsuite.com/api/portal/project/detail?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/project/detail',
    params={'portal_id': 'vJW4', 'project_id': 328},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"project_id\":[\"The project id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Project record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'project_id' => 328,
    'name' => 'Website redesign (phase 2)',
    'description' => '
Homepage, pricing and blog.
',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', project_id: '328', name: 'Website redesign (phase 2)', description: '
Homepage, pricing and blog.
' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/update',
    data={'portal_id': 'vJW4', 'project_id': 328, 'name': 'Website redesign (phase 2)', 'description': '
Homepage, pricing and blog.
'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Project record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'project_id' => 328,
    'name' => 'Discovery',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/phase/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', project_id: '328', name: 'Discovery' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/phase/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/phase/add',
    data={'portal_id': 'vJW4', 'project_id': 328, 'name': 'Discovery'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"name\":[\"The name may not be greater than 200 characters.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Project record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'project_id' => 328,
    'phase_id' => 94,
    'name' => 'Discovery & research',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/phase/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({ portal_id: 'vJW4', project_id: '328', phase_id: '94', name: 'Discovery & research' });

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/phase/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/phase/update',
    data={'portal_id': 'vJW4', 'project_id': 328, 'phase_id': 94, 'name': 'Discovery & research'},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Phase name is blank."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Phase record not found on this project."
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'project_id' => 328,
    'task_ids' => [3659, 3702],
    'phase_id' => 92,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/task/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('project_id', '328');
body.append('task_ids[]', '3659');
body.append('task_ids[]', '3702');
body.append('phase_id', '92');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/task/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/task/add',
    data={'portal_id': 'vJW4', 'project_id': 328, 'task_ids[]': [3659, 3702], 'phase_id': 92},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"task_ids\":[\"The task ids field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Task record not found: 3999"
}

$ch = curl_init();
$data = [
    'portal_id' => 'vJW4',
    'project_id' => 328,
    'resources' => [
        ['type' => 'page', 'id' => 'l78w'],
        ['type' => 'file', 'id' => 'ZrV1'],
        ['type' => 'conversation', 'id' => '276'],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/project/resource/add');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('portal_id', 'vJW4');
body.append('project_id', '328');
body.append('resources[0][type]', 'page');
body.append('resources[0][id]', 'l78w');
body.append('resources[1][type]', 'file');
body.append('resources[1][id]', 'ZrV1');
body.append('resources[2][type]', 'conversation');
body.append('resources[2][id]', '276');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/project/resource/add', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/project/resource/add',
    data={
        'portal_id': 'vJW4', 'project_id': 328,
        'resources[0][type]': 'page', 'resources[0][id]': 'l78w',
        'resources[1][type]': 'file', 'resources[1][id]': 'ZrV1',
        'resources[2][type]': 'conversation', 'resources[2][id]': '276',
    },
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "These resources are already linked to the project — nothing to change."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "resources[1]: file ZrV9 not found in this portal."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'email' => 'contact@example.com',
    'name' => 'Contact Name',
    'default_permissions[email_receive]' => 1,
    'default_permissions[allow_page_add]' => 1,
    'send_client_email_notify' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/contact/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  email: 'contact@example.com',
  name: 'Contact Name',
  'default_permissions[email_receive]': '1',
  'default_permissions[allow_page_add]': '1',
  send_client_email_notify: '1',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/contact/create', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/contact/create',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'email': 'contact@example.com',
        'name': 'Contact Name',
        'default_permissions[email_receive]': 1,
        'default_permissions[allow_page_add]': 1,
        'send_client_email_notify': 1,
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"email\":[\"The email field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'portal_id' => 'vJW4',
    'page' => 1,
    'limit' => 20,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/contact/list?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ portal_id: 'vJW4', page: 1, limit: 20 });
const res = await fetch(`https://ahsuite.com/api/portal/contact/list?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/portal/contact/list',
    params={'portal_id': 'vJW4', 'page': 1, 'limit': 20},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"portal_id\":[\"The portal id field is required.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'timezone' => 'America/Phoenix',
    'language' => 'en',
    'portal_search' => 1,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/preferences/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  timezone: 'America/Phoenix',
  language: 'en',
  portal_search: '1',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/preferences/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/preferences/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'timezone': 'America/Phoenix',
        'language': 'en',
        'portal_search': 1,
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"timezone\":[\"The timezone must be a valid zone.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'show_pages' => 1,
    'show_password' => 0,
    'label_tasks' => 'Action Items',
    'links' => [
        ['name' => 'Our Website', 'url' => 'https://example.com', 'same' => 0],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/sidebar/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  show_pages: '1',
  show_password: '0',
  label_tasks: 'Action Items',
  'links[0][name]': 'Our Website',
  'links[0][url]': 'https://example.com',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/sidebar/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/sidebar/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'show_pages': 1,
        'show_password': 0,
        'label_tasks': 'Action Items',
        'links[0][name]': 'Our Website',
        'links[0][url]': 'https://example.com',
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"show_pages\":[\"The selected show pages is invalid.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'show_card' => 1,
    'show_phone' => 0,
    'display_name' => 'Priya Sharma',
    'title' => 'Account Executive',
    'action_buttons' => [
        'schedule' => [
            'enabled' => 1,
            'text' => 'Schedule a Call',
            'calendar_link' => 'https://calendly.com/priya',
        ],
        'primary' => 'schedule',
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/account-manager/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  show_card: '1',
  show_phone: '0',
  display_name: 'Priya Sharma',
  title: 'Account Executive',
  'action_buttons[schedule][enabled]': '1',
  'action_buttons[schedule][text]': 'Schedule a Call',
  'action_buttons[schedule][calendar_link]': 'https://calendly.com/priya',
  'action_buttons[primary]': 'schedule',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/account-manager/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/account-manager/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'show_card': 1,
        'show_phone': 0,
        'display_name': 'Priya Sharma',
        'title': 'Account Executive',
        'action_buttons[schedule][enabled]': 1,
        'action_buttons[schedule][text]': 'Schedule a Call',
        'action_buttons[schedule][calendar_link]': 'https://calendly.com/priya',
        'action_buttons[primary]': 'schedule',
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"action_buttons.primary\":[\"The selected action buttons.primary is invalid.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'email_receive' => 1,
    'allow_page_add' => 0,
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/client-user/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  email_receive: '1',
  allow_page_add: '0',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/client-user/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/client-user/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'email_receive': 1,
        'allow_page_add': 0,
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'logo' => new CURLFile('/path/to/logo.png'),
    'custom_css' => '.portal-header { background: #1a1a2e; }',
    'website' => 'https://client-website.com',
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/branding/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';
import FormData from 'form-data';
import fs from 'fs';

const form = new FormData();
form.append('portal_id', 'PORTAL_ID');
form.append('logo', fs.createReadStream('/path/to/logo.png'));
form.append('custom_css', '.portal-header { background: #1a1a2e; }');
form.append('website', 'https://client-website.com');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/branding/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/branding/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'custom_css': '.portal-header { background: #1a1a2e; }',
        'website': 'https://client-website.com',
    },
    files={'logo': open('/path/to/logo.png', 'rb')},
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'summary_email_frequency' => 'weekly',
    'emails' => [
        'invitation' => [
            'subject' => 'You are invited to your client portal',
            'body' => 'Hi, your portal is ready. Click below to log in.',
        ],
        'needs_attention' => [
            'body' => ['task_heading' => 'Tasks waiting for you'],
        ],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/email-notifications/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  summary_email_frequency: 'weekly',
  'emails[invitation][subject]': 'You are invited to your client portal',
  'emails[invitation][body]': 'Hi, your portal is ready. Click below to log in.',
  'emails[needs_attention][body][task_heading]': 'Tasks waiting for you',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/email-notifications/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/email-notifications/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'summary_email_frequency': 'weekly',
        'emails[invitation][subject]': 'You are invited to your client portal',
        'emails[invitation][body]': 'Hi, your portal is ready. Click below to log in.',
        'emails[needs_attention][body][task_heading]': 'Tasks waiting for you',
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$ch = curl_init();
$data = [
    'portal_id' => 'PORTAL_ID',
    'variables' => [
        ['name' => 'address', 'scope' => 'portal', 'value' => '221B Baker Street'],
        ['name' => 'phone', 'scope' => 'user'],
    ],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/portal/settings/variables/update');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams({
  portal_id: 'PORTAL_ID',
  'variables[0][name]': 'address',
  'variables[0][scope]': 'portal',
  'variables[0][value]': '221B Baker Street',
  'variables[1][name]': 'phone',
  'variables[1][scope]': 'user',
});

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/portal/settings/variables/update', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/portal/settings/variables/update',
    auth=('EMAIL', 'TOKEN'),
    data={
        'portal_id': 'PORTAL_ID',
        'variables[0][name]': 'address',
        'variables[0][scope]': 'portal',
        'variables[0][value]': '221B Baker Street',
        'variables[1][name]': 'phone',
        'variables[1][scope]': 'user',
    },
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "No settings were sent to update."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Portal record not found."
}

$params = http_build_query([
    'unread_only' => 1,
    'page' => 1,
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/notifications?'.$params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const params = new URLSearchParams({ unread_only: '1', page: '1' });
const res = await fetch(`https://ahsuite.com/api/notifications?${params}`, {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/notifications',
    params={'unread_only': 1, 'page': 1},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "{\"page\":[\"The page must be at least 1.\"]}"
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

$ch = curl_init();
$data = [
    'notification_ids' => [130, 129],
];
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/notifications/read');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const body = new URLSearchParams();
body.append('notification_ids[]', '130');
body.append('notification_ids[]', '129');

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/notifications/read', {
  method: 'POST',
  headers: { Authorization: `Basic ${auth}` },
  body,
});
console.log(await res.json());

import requests

res = requests.post(
    'https://ahsuite.com/api/notifications/read',
    data={'notification_ids[]': [130, 129]},
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Validation Error",
  "data": "Send exactly one of: notification_ids or all=1."
}

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}

{
  "success": false,
  "message": "Not Found",
  "data": "Notification record not found: 999"
}

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://ahsuite.com/api/timezones');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);

import fetch from 'node-fetch';

const auth = Buffer.from('EMAIL:TOKEN').toString('base64');
const res = await fetch('https://ahsuite.com/api/timezones', {
  headers: { Authorization: `Basic ${auth}` },
});
console.log(await res.json());

import requests

res = requests.get(
    'https://ahsuite.com/api/timezones',
    auth=('EMAIL', 'TOKEN'),
)
print(res.json())

{
  "success": false,
  "message": "Invalid owner email and authorization_token."
}