***

title: addSection
slug: /reference/typescript/agents/pom-builder/add-section
description: Add a new top-level section to the POM.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[ref-pombuilder]: /docs/server-sdks/reference/typescript/agents/pom-builder

Add a new top-level section to the POM.

## **Parameters**

<ParamField path="title" type="string" required={true} toc={true}>
  Section title.
</ParamField>

<ParamField path="opts" type="object" toc={true}>
  Optional section content.
</ParamField>

<Indent>
  <ParamField path="opts.body" type="string" toc={true}>
    Section body text.
  </ParamField>

  <ParamField path="opts.bullets" type="string[]" toc={true}>
    List of bullet points for this section.
  </ParamField>

  <ParamField path="opts.numbered" type="boolean" toc={true}>
    Whether to number this section in the rendered output.
  </ParamField>

  <ParamField path="opts.numberedBullets" type="boolean" toc={true}>
    Whether to number bullet points instead of using bullet markers.
  </ParamField>

  <ParamField path="opts.subsections" type={"{ title: string; body?: string; bullets?: string[] }[]"} toc={true}>
    List of subsection objects, each with `"title"`, optional `"body"`, and
    optional `"bullets"` keys.
  </ParamField>
</Indent>

## **Returns**

[`PomBuilder`][ref-pombuilder] -- Self for method chaining.

## **Example**

```typescript {4}
import { PomBuilder } from '@signalwire/sdk';

const pom = new PomBuilder();
pom.addSection('Role', {
  body: 'You are a helpful assistant.',
  bullets: ['Be concise', 'Be accurate'],
  subsections: [
    { title: 'Tone', body: 'Use a friendly, professional tone.' },
  ],
});
```