Change or end registered agent service

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    status: 'change_requested',
    registered_agent: {
      type: 'person',
      name: {
        type: 'person',
        first: 'Jane',
        last: 'Doe',
        middle: 'A.',
        suffix: 'Jr.',
        entity_name: 'Acme Holdings LLC'
      },
      address: {
        street_line_1: '123 Main St',
        city: 'Raleigh',
        region: 'NC',
        postal_code: '27601',
        country: 'US',
        street_line_2: 'Suite 200',
        county: 'Mecklenburg'
      },
      email: 'agent@example.com',
      phone: '919-555-1234'
    },
    reason: 'switching_providers',
    reason_detail: 'Moving RA service in-house effective end of quarter.',
    metadata: {case_id: 'case_abc123'}
  })
};

fetch('https://api.getpalm.com/v1/business/{business_id}/registered-agent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/business/{business_id}/registered-agent"

payload = {
    "status": "change_requested",
    "registered_agent": {
        "type": "person",
        "name": {
            "type": "person",
            "first": "Jane",
            "last": "Doe",
            "middle": "A.",
            "suffix": "Jr.",
            "entity_name": "Acme Holdings LLC"
        },
        "address": {
            "street_line_1": "123 Main St",
            "city": "Raleigh",
            "region": "NC",
            "postal_code": "27601",
            "country": "US",
            "street_line_2": "Suite 200",
            "county": "Mecklenburg"
        },
        "email": "agent@example.com",
        "phone": "919-555-1234"
    },
    "reason": "switching_providers",
    "reason_detail": "Moving RA service in-house effective end of quarter.",
    "metadata": { "case_id": "case_abc123" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

curl --request PATCH \
  --url https://api.getpalm.com/v1/business/{business_id}/registered-agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "change_requested",
  "registered_agent": {
    "type": "person",
    "name": {
      "type": "person",
      "first": "Jane",
      "last": "Doe",
      "middle": "A.",
      "suffix": "Jr.",
      "entity_name": "Acme Holdings LLC"
    },
    "address": {
      "street_line_1": "123 Main St",
      "city": "Raleigh",
      "region": "NC",
      "postal_code": "27601",
      "country": "US",
      "street_line_2": "Suite 200",
      "county": "Mecklenburg"
    },
    "email": "agent@example.com",
    "phone": "919-555-1234"
  },
  "reason": "switching_providers",
  "reason_detail": "Moving RA service in-house effective end of quarter.",
  "metadata": {
    "case_id": "case_abc123"
  }
}
'

{
  "object": "registered_agent",
  "business_id": "987e6543-e21a-45b6-c789-012345678901",
  "provider": "palm",
  "status": "active",
  "jurisdiction": "CA",
  "started_at": "2026-05-29T10:30:00Z",
  "ended_at": null,
  "rejection_reason": "State refused resignation form: GA requires a successor RA designation",
  "name": "Acme Registered Agent Services, Inc.",
  "address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  }
}

Registered Agent

Change or end registered agent service

⚠️ Early access — This endpoint is in preview and may change in backwards-incompatible ways before it is marked stable. Avoid depending on it in production, and reach out before building on it.

Updates the registered agent on a business. Both actions are discriminated by status:

change_requested — change the RA of record. Supply registered_agent to switch to your own / a different RA, or omit it to switch to Palm-provided service. The RA moves to pending; on completion registered_agent.activated (into Palm) or registered_agent.changed (away) fires. Any state-side filing this requires happens internally. The business must have a formation_jurisdiction. Returns 409 if a registered agent operation is already in flight (pending or termination_requested).
termination_requested — ask Palm to stop serving as RA. Sets status to termination_requested; Palm remains RA on file and keeps forwarding mail until the work completes, when registered_agent.terminated fires. Returns 409 if the service is not currently active.

In test mode both actions complete immediately: termination fires registered_agent.termination_requested and registered_agent.terminated and returns the terminal snapshot (status: terminated).

PATCH

business

{business_id}

registered-agent

Change or end registered agent service

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    status: 'change_requested',
    registered_agent: {
      type: 'person',
      name: {
        type: 'person',
        first: 'Jane',
        last: 'Doe',
        middle: 'A.',
        suffix: 'Jr.',
        entity_name: 'Acme Holdings LLC'
      },
      address: {
        street_line_1: '123 Main St',
        city: 'Raleigh',
        region: 'NC',
        postal_code: '27601',
        country: 'US',
        street_line_2: 'Suite 200',
        county: 'Mecklenburg'
      },
      email: 'agent@example.com',
      phone: '919-555-1234'
    },
    reason: 'switching_providers',
    reason_detail: 'Moving RA service in-house effective end of quarter.',
    metadata: {case_id: 'case_abc123'}
  })
};

fetch('https://api.getpalm.com/v1/business/{business_id}/registered-agent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/business/{business_id}/registered-agent"

payload = {
    "status": "change_requested",
    "registered_agent": {
        "type": "person",
        "name": {
            "type": "person",
            "first": "Jane",
            "last": "Doe",
            "middle": "A.",
            "suffix": "Jr.",
            "entity_name": "Acme Holdings LLC"
        },
        "address": {
            "street_line_1": "123 Main St",
            "city": "Raleigh",
            "region": "NC",
            "postal_code": "27601",
            "country": "US",
            "street_line_2": "Suite 200",
            "county": "Mecklenburg"
        },
        "email": "agent@example.com",
        "phone": "919-555-1234"
    },
    "reason": "switching_providers",
    "reason_detail": "Moving RA service in-house effective end of quarter.",
    "metadata": { "case_id": "case_abc123" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

curl --request PATCH \
  --url https://api.getpalm.com/v1/business/{business_id}/registered-agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "change_requested",
  "registered_agent": {
    "type": "person",
    "name": {
      "type": "person",
      "first": "Jane",
      "last": "Doe",
      "middle": "A.",
      "suffix": "Jr.",
      "entity_name": "Acme Holdings LLC"
    },
    "address": {
      "street_line_1": "123 Main St",
      "city": "Raleigh",
      "region": "NC",
      "postal_code": "27601",
      "country": "US",
      "street_line_2": "Suite 200",
      "county": "Mecklenburg"
    },
    "email": "agent@example.com",
    "phone": "919-555-1234"
  },
  "reason": "switching_providers",
  "reason_detail": "Moving RA service in-house effective end of quarter.",
  "metadata": {
    "case_id": "case_abc123"
  }
}
'

{
  "object": "registered_agent",
  "business_id": "987e6543-e21a-45b6-c789-012345678901",
  "provider": "palm",
  "status": "active",
  "jurisdiction": "CA",
  "started_at": "2026-05-29T10:30:00Z",
  "ended_at": null,
  "rejection_reason": "State refused resignation form: GA requires a successor RA designation",
  "name": "Acme Registered Agent Services, Inc.",
  "address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  }
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Path Parameters

business_id

string<uuid>

required

Portfolio business ID

Example:

"987e6543-e21a-45b6-c789-012345678901"

Body

application/json

status

enum<string>

required

Which update to perform. Discriminates the rest of the body.

Available options:

change_requested,

termination_requested

Example:

"change_requested"

registered_agent

object | null

New registered agent (when status=change_requested). Supply agent details to change to your own / a different RA; omit to switch to Palm-provided service.

Show child attributes

reason

enum<string>

Why Palm RA service is being terminated (required when status=termination_requested).

Available options:

switching_providers,

business_dissolved,

business_offboarding,

other

Example:

"switching_providers"

reason_detail

string | null

Optional free-text context. Required by convention when reason is other.

Maximum string length: 500

Example:

"Moving RA service in-house effective end of quarter."

metadata

object

Optional metadata, round-tripped on the resulting work item.

Example:

{ "case_id": "case_abc123" }

Response

Registered agent update accepted

object

enum<string>

required

Object type identifier, always "registered_agent"

Available options:

registered_agent

Example:

"registered_agent"

business_id

string<uuid>

required

Business this RA-service state belongs to

Example:

"987e6543-e21a-45b6-c789-012345678901"

provider

enum<string> | null

required

Who provides RA service. palm when Palm provides service, external when the partner uses a different RA, null when no RA is tracked.

Available options:

palm,

external

Example:

"palm"

status

enum<string> | null

required

Lifecycle status of Palm-provided RA service. null when the partner uses an external RA or has never used Palm RA.

Available options:

pending,

active,

termination_requested,

terminated,

failed,

canceled

Example:

"active"

jurisdiction

string | null

required

Jurisdiction (state) the RA service is for

Example:

"CA"

started_at

string<date-time> | null

required

ISO 8601 timestamp when the current service window started

Example:

"2026-05-29T10:30:00Z"

ended_at

string<date-time> | null

required

ISO 8601 timestamp when the most recent service window ended (null while active)

Example:

null

rejection_reason

string | null

Why the service did not proceed. Carries the rejection reason on the registered_agent.failed, registered_agent.change_failed, and registered_agent.termination_failed webhook payloads, and the cancellation reason on registered_agent.canceled. Null on every other event and on reads of the resource.

Example:

"State refused resignation form: GA requires a successor RA designation"

name

string | null

Name of the registered agent of record for the business in this jurisdiction. Populated when Palm provides RA service and the agent has been assigned; null otherwise.

Example:

"Acme Registered Agent Services, Inc."

address

object | null

Mailing address of the registered agent of record. Populated when Palm provides RA service and the agent has been assigned; null otherwise.

Show child attributes

Palm Introduction

API Introduction

Endpoints

Change or end registered agent service

Authorizations

Path Parameters

Body

Response