List Connection Profiles

GET

api

profiles

List connection profiles

curl --request GET \
  --url https://mallary.ai/api/v1/profiles \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://mallary.ai/api/v1/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mallary.ai/api/v1/profiles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://mallary.ai/api/v1/profiles"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://mallary.ai/api/v1/profiles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "status": "ok",
  "data": {
    "profiles": [
      {
        "id": "AbC123xYz90",
        "name": "<string>",
        "is_default": true,
        "connected_platforms": [],
        "platform_profiles": {},
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "default_profile_id": "<string>",
    "limits": {
      "max_accounts_per_platform": 123
    }
  }
}

Connection profiles group your social media accounts. Create one profile for each of your businesses. Then connect the social media accounts of that business inside its profile. If you do not send a profile_id, Mallary uses your default profile. Each profile has a random public ID, such as AbC123xYz90. Use that ID as profile_id in API, MCP, and CLI requests. Omit profile_id on publishing and reporting endpoints to use the default profile. Send profile_id when you want to target a non-default profile.

Authorizations

Authorization

string

header

required

Use Authorization: Bearer {api_key}

Response

Connection profiles retrieved

status

enum<string>

Available options:

ok

data

object

Show child attributes

Last modified on July 30, 2026

List connection profiles

curl --request GET \
  --url https://mallary.ai/api/v1/profiles \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://mallary.ai/api/v1/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mallary.ai/api/v1/profiles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://mallary.ai/api/v1/profiles"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://mallary.ai/api/v1/profiles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "status": "ok",
  "data": {
    "profiles": [
      {
        "id": "AbC123xYz90",
        "name": "<string>",
        "is_default": true,
        "connected_platforms": [],
        "platform_profiles": {},
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "default_profile_id": "<string>",
    "limits": {
      "max_accounts_per_platform": 123
    }
  }
}

Overview

Endpoints

Authorizations

Response