const axios = require('axios');
const ContactsApiFp = require('@alohi/faxplus-api').ContactsApiFp;
const Configuration = require('@alohi/faxplus-api').Configuration;
const config = new Configuration({
accessToken: accessToken,
basePath: 'https://restapi.fax.plus/v3',
baseOptions: {
headers: {
"x-fax-clientid": clientId,
}
}
});
async function listContactGroups() {
const req = await ContactsApiFp(config).listContactGroups({
userId: 'self',
search: '',
offset: 0,
limit: 50
});
const resp = await req(axios);
}
listContactGroups()
from faxplus import ApiClient, ContactsApi
from faxplus.configuration import Configuration
conf = Configuration()
conf.access_token = access_token
api_client = ApiClient(header_name='x-fax-clientid', header_value=client_id, configuration=conf)
api = ContactsApi(api_client)
resp = api.list_contact_groups(user_id='self', search='', offset=0, limit=50)
curl -X GET https://restapi.fax.plus/v3/accounts/self/contact-groups?search=&offset=0&limit=50 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}' \
-H 'x-fax-clientid: "YOUR_CLIENT_ID"'
{
"records": [
{
"id": "5f7a8b9c0d1e2f3a4b5c6d7f",
"name": "VIP Clients",
"notes": "Important clients only",
"is_shared": true,
"creation_date": "2024-01-10T09:00:00Z",
"modification_date": "2024-02-15T11:20:00Z"
}
],
"total_count": 123
}{
"error": "invalid_user_id",
"description": "Invalid user id given"
}{
"error": "unauthorized",
"description": "The access token provided is expired, revoked, malformed, or invalid for other reasons."
}{
"error": "internal_server_error",
"description": "An unexpected error happened, please contact support"
}Contacts
List contact groups
Get contact groups with optional search and pagination. You can also retrieve specific groups by providing comma-separated IDs (Permitted scopes: fax:all:read)
GET
/
accounts
/
self
/
contact-groups
const axios = require('axios');
const ContactsApiFp = require('@alohi/faxplus-api').ContactsApiFp;
const Configuration = require('@alohi/faxplus-api').Configuration;
const config = new Configuration({
accessToken: accessToken,
basePath: 'https://restapi.fax.plus/v3',
baseOptions: {
headers: {
"x-fax-clientid": clientId,
}
}
});
async function listContactGroups() {
const req = await ContactsApiFp(config).listContactGroups({
userId: 'self',
search: '',
offset: 0,
limit: 50
});
const resp = await req(axios);
}
listContactGroups()
from faxplus import ApiClient, ContactsApi
from faxplus.configuration import Configuration
conf = Configuration()
conf.access_token = access_token
api_client = ApiClient(header_name='x-fax-clientid', header_value=client_id, configuration=conf)
api = ContactsApi(api_client)
resp = api.list_contact_groups(user_id='self', search='', offset=0, limit=50)
curl -X GET https://restapi.fax.plus/v3/accounts/self/contact-groups?search=&offset=0&limit=50 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}' \
-H 'x-fax-clientid: "YOUR_CLIENT_ID"'
{
"records": [
{
"id": "5f7a8b9c0d1e2f3a4b5c6d7f",
"name": "VIP Clients",
"notes": "Important clients only",
"is_shared": true,
"creation_date": "2024-01-10T09:00:00Z",
"modification_date": "2024-02-15T11:20:00Z"
}
],
"total_count": 123
}{
"error": "invalid_user_id",
"description": "Invalid user id given"
}{
"error": "unauthorized",
"description": "The access token provided is expired, revoked, malformed, or invalid for other reasons."
}{
"error": "internal_server_error",
"description": "An unexpected error happened, please contact support"
}const axios = require('axios');
const ContactsApiFp = require('@alohi/faxplus-api').ContactsApiFp;
const Configuration = require('@alohi/faxplus-api').Configuration;
const config = new Configuration({
accessToken: accessToken,
basePath: 'https://restapi.fax.plus/v3',
baseOptions: {
headers: {
"x-fax-clientid": clientId,
}
}
});
async function listContactGroups() {
const req = await ContactsApiFp(config).listContactGroups({
userId: 'self',
search: '',
offset: 0,
limit: 50
});
const resp = await req(axios);
}
listContactGroups()
from faxplus import ApiClient, ContactsApi
from faxplus.configuration import Configuration
conf = Configuration()
conf.access_token = access_token
api_client = ApiClient(header_name='x-fax-clientid', header_value=client_id, configuration=conf)
api = ContactsApi(api_client)
resp = api.list_contact_groups(user_id='self', search='', offset=0, limit=50)
curl -X GET https://restapi.fax.plus/v3/accounts/self/contact-groups?search=&offset=0&limit=50 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}' \
-H 'x-fax-clientid: "YOUR_CLIENT_ID"'
Authorizations
personal_access_tokenoauth2
Personal Access Token (PAT) is a Bearer token used for secure API calls. For direct API calls, the PAT is used in the Authorization header as 'Bearer {PAT}'. For MCP usage, configure your PAT in your MCP client settings (e.g., in your IDE's MCP server configuration) - authentication will be handled automatically.
Query Parameters
Comma-separated list of group IDs to retrieve (max 50). When provided, other filters are ignored
Search term to filter groups
Offset for pagination
Limit for pagination (max 50)
Required range:
x <= 50If true, return shared/corporate groups. If false, return personal groups