> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# addVerbToSection

> Append a verb to a named section, creating the section if it does not exist.

[add-verb]: /docs/server-sdks/reference/typescript/agents/swml-builder/add-verb

Append a verb to a named section of the SWML document. If the section does not
exist, it is created automatically. The verb config is validated against the
bundled schema when validation is enabled, exactly as in [`addVerb()`][add-verb].

> **Unknown verbs and keys throw**
>
> Validation is strict. An unknown verb name, an unknown or misspelled key inside
> the verb config, or a value of the wrong type throws a `SchemaValidationError`
> instead of being dropped silently. Earlier SDK versions appended to non-main
> sections without validating. Set `SWML_SKIP_SCHEMA_VALIDATION=true` to disable
> validation.

## **Parameters**

**`sectionName`** `string` — required

The target section name.

---

**`verbName`** `string` — required

The SWML verb name (e.g., `"answer"`, `"play"`, `"hangup"`).

---

**`config`** `unknown` — required

The verb's configuration payload.

---

## **Returns**

`void`

## **Example**

```typescript {5}
import { SwmlBuilder } from '@signalwire/sdk';

const builder = new SwmlBuilder();
builder.addVerb('answer', {});
builder.addVerbToSection('goodbye', 'play', {
  url: 'https://example.com/goodbye.mp3',
});
builder.addVerbToSection('goodbye', 'hangup', {});

console.log(builder.render());
```

> Append a verb to a named section, creating the section if it does not exist.