Get Company Profile

curl --request GET \
  --url https://app.puffle.ai/api/context \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.puffle.ai/api/context', 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://app.puffle.ai/api/context",
  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://app.puffle.ai/api/context"

	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://app.puffle.ai/api/context")

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

{
  "context": {
    "user": {
      "professionalBackground": "Former B2B SaaS founder, now building GTM tooling."
    },
    "company": {
      "overview": "Puffle is a unified GTM platform for founders finding prospects and running outbound in one place.",
      "product": "Feed and Lead Finder search preparation + multi-channel Outbound + Unibox reply management.",
      "problemSolved": "Founders stitching together 8+ tools to run outbound.",
      "differentiators": "Single workspace, AI-native, built for founders who drive sales themselves.",
      "linkedInPresence": "Active founder-led presence, product-build-in-public posts."
    },
    "content": {
      "linkedInVoice": "Direct, candid, founder-to-founder.",
      "recommendedTopics": [
        "outbound",
        "GTM",
        "AI sales tooling"
      ],
      "preferredTone": "Confident, plainspoken, no fluff.",
      "contentFormats": [
        "text post",
        "carousel"
      ],
      "topicsToAvoid": [
        "politics",
        "motivational platitudes"
      ],
      "postingCadence": "3x/week"
    },
    "market": {
      "targetAudience": "Series A–B B2B SaaS founders running their own outbound.",
      "industryContext": "Crowded sales tooling market with fragmented point solutions.",
      "icpJobTitles": [
        "Founder",
        "CEO",
        "Head of GTM"
      ],
      "icpIndustries": [
        "B2B SaaS",
        "Developer tools",
        "Fintech"
      ],
      "icpCompanySizes": [
        "11-50",
        "51-200"
      ],
      "icpPainPoints": [
        "Manually coordinating across 8 tools",
        "Brittle enrichment data"
      ],
      "icpKeywords": [
        "outbound",
        "GTM",
        "founder-led sales"
      ]
    },
    "extra": null
  },
  "profile": {
    "firstName": "Sarah",
    "lastName": "Chen",
    "companyName": "Acme",
    "website": "https://acme.com",
    "linkedinUrl": "https://linkedin.com/in/sarahchen",
    "companyLinkedinUrl": "https://linkedin.com/company/acme",
    "lastContextRegeneratedAt": "2026-04-19T12:00:00Z"
  }
}

GET

api

context

Get Company Profile

curl --request GET \
  --url https://app.puffle.ai/api/context \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.puffle.ai/api/context', 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://app.puffle.ai/api/context",
  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://app.puffle.ai/api/context"

	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://app.puffle.ai/api/context")

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

{
  "context": {
    "user": {
      "professionalBackground": "Former B2B SaaS founder, now building GTM tooling."
    },
    "company": {
      "overview": "Puffle is a unified GTM platform for founders finding prospects and running outbound in one place.",
      "product": "Feed and Lead Finder search preparation + multi-channel Outbound + Unibox reply management.",
      "problemSolved": "Founders stitching together 8+ tools to run outbound.",
      "differentiators": "Single workspace, AI-native, built for founders who drive sales themselves.",
      "linkedInPresence": "Active founder-led presence, product-build-in-public posts."
    },
    "content": {
      "linkedInVoice": "Direct, candid, founder-to-founder.",
      "recommendedTopics": [
        "outbound",
        "GTM",
        "AI sales tooling"
      ],
      "preferredTone": "Confident, plainspoken, no fluff.",
      "contentFormats": [
        "text post",
        "carousel"
      ],
      "topicsToAvoid": [
        "politics",
        "motivational platitudes"
      ],
      "postingCadence": "3x/week"
    },
    "market": {
      "targetAudience": "Series A–B B2B SaaS founders running their own outbound.",
      "industryContext": "Crowded sales tooling market with fragmented point solutions.",
      "icpJobTitles": [
        "Founder",
        "CEO",
        "Head of GTM"
      ],
      "icpIndustries": [
        "B2B SaaS",
        "Developer tools",
        "Fintech"
      ],
      "icpCompanySizes": [
        "11-50",
        "51-200"
      ],
      "icpPainPoints": [
        "Manually coordinating across 8 tools",
        "Brittle enrichment data"
      ],
      "icpKeywords": [
        "outbound",
        "GTM",
        "founder-led sales"
      ]
    },
    "extra": null
  },
  "profile": {
    "firstName": "Sarah",
    "lastName": "Chen",
    "companyName": "Acme",
    "website": "https://acme.com",
    "linkedinUrl": "https://linkedin.com/in/sarahchen",
    "companyLinkedinUrl": "https://linkedin.com/company/acme",
    "lastContextRegeneratedAt": "2026-04-19T12:00:00Z"
  }
}

CLI:

puffle context

Overview

Returns the saved company profile for the authenticated workspace. The profile is the operating context Puffle uses for Feed and Lead Finder search preparation, search reassessment, and outbound message generation. The response includes the assembled context object and profile identity fields. New or incomplete workspaces can return context: null or profile: null; treat that as setup not finished rather than an empty ICP.

AI agent notes

Call this during the boot sequence before launching workflows that depend on ICP, company positioning, content voice, or market assumptions. If the profile is missing, stop and ask the human to finish setup or provide the missing details. Do not invent company profile fields. To change the profile, fetch the current object first, preserve fields the human did not change, then send the full object to Update Company Profile.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Context + identity fields. Both are null when the workspace has no profile row yet (new user mid-onboarding).

context

object | null

required

Assembled company profile. Each sub-object is stored as a separate JSONB column on user_profiles and merged at read time.

Show child attributes

profile

object | null

required

Identity fields stored alongside the context JSONB columns. Returned so a UI can render a full profile page without a second round-trip.

Show child attributes

​Overview

​AI agent notes

Authorizations

Response

Overview

AI agent notes