> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# addAudioTrack

API reference for the addAudioTrack method.

Adds an audio track to the user's design.

## Usage: Add audio track to design

```typescript
import { addAudioTrack } from "@canva/design";
import type { AudioTrack } from "@canva/design";
import type { AudioRef } from "@canva/asset";

const exampleAudioRef = "YOUR_AUDIO_REF" as AudioRef;

const audioTrack: AudioTrack = {
  ref: exampleAudioRef
};

await addAudioTrack(audioTrack);
```

## Parameters

<Prop.List>
  <Prop name="audioTrack" required type="AudioTrack" sourceLineNumbers={[49]}>
    The audio track to add to the user's design.

    <PillAccordion defaultExpanded={true} title={<>Properties of <strong>audioTrack</strong></>}>
      <Prop.List>
        <Prop name="ref" required type="AudioRef" sourceLineNumbers={[1005]}>
          A unique identifier that points to an audio asset in Canva's backend.
        </Prop>
      </Prop.List>
    </PillAccordion>
  </Prop>
</Prop.List>

## Returns

`Promise<void>`

## Permissions

To use this method, the `canva:design:content:write` permission must be enabled for the app. To learn more, see [Permissions](https://www.canva.dev/docs/apps/configuring-intents-permissions/).