***

title: Account Setup
description: Create and configure your SignalWire account to connect agents to phone numbers.
slug: /guides/account-setup
max-toc-depth: 3
---------------------

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

[account-setup]: /docs/server-sdks/guides/account-setup

[phone-numbers]: /docs/server-sdks/guides/phone-numbers

[mapping-numbers]: /docs/server-sdks/guides/mapping-numbers

[testing]: /docs/server-sdks/guides/testing

[troubleshooting]: /docs/server-sdks/guides/troubleshooting

## What You'll Learn

This chapter covers SignalWire integration:

1. **Account Setup** - Create and configure your SignalWire account
2. **Phone Numbers** - Purchase and manage phone numbers
3. **Mapping Numbers** - Connect phone numbers to your agents
4. **Testing** - Test your agents before going live
5. **Troubleshooting** - Common issues and solutions

## Integration Overview

<Frame caption="SignalWire Integration">
  <img class="diagram" src="https://files.buildwithfern.com/signalwire.docs.buildwithfern.com/docs/d2af6781d397c6656786341b2f1ce1ade8e9f5728d5ac3977fe325accfc0de93/assets/images/sdks/diagrams/08_01_account-setup_diagram1.webp" alt="SignalWire integration overview." />
</Frame>

## Prerequisites

Before connecting to SignalWire:

* Working agent (tested locally)
* Publicly accessible server
* SignalWire account

## Chapter Contents

| Section                            | Description                           |
| ---------------------------------- | ------------------------------------- |
| [Account Setup][account-setup]     | Create SignalWire account and project |
| [Phone Numbers][phone-numbers]     | Purchase and manage numbers           |
| [Mapping Numbers][mapping-numbers] | Connect numbers to agents             |
| [Testing][testing]                 | Test calls and debugging              |
| [Troubleshooting][troubleshooting] | Common issues and fixes               |

## Quick Integration Steps

### Step 1: Account Setup

* Create SignalWire account
* Create a project
* Note your Space Name

### Step 2: Phone Number

* Purchase a phone number
* Or use a SIP endpoint

### Step 3: Deploy Agent

* Deploy agent to public URL
* Verify HTTPS is working
* Test SWML endpoint responds

### Step 4: Connect

* Point phone number to agent URL
* Make test call
* Verify agent responds

## Architecture

<Frame caption="Call Flow Architecture">
  <img class="diagram" src="https://files.buildwithfern.com/signalwire.docs.buildwithfern.com/docs/a2108fedf6f5524f1dde83a9d1a8a35a7906859adf88cc0f570e11b6bb9a9721/assets/images/sdks/diagrams/08_01_account-setup_diagram2.webp" alt="Call flow architecture between SignalWire and your agent." />
</Frame>

## Required URLs

Your agent needs to be accessible at these endpoints:

| Endpoint | Method | Purpose              |
| -------- | ------ | -------------------- |
| `/`      | POST   | Main SWML document   |
| `/swaig` | POST   | SWAIG function calls |

## Security Considerations

* Always use HTTPS for production
* Enable basic auth for SWML endpoints
* Use secure tokens for SWAIG functions
* Don't expose sensitive data in prompts
* Monitor for unusual call patterns

Let's start with setting up your SignalWire account.

## Create Account

1. Go to [signalwire.com](https://signalwire.com)
2. Click [Sign Up](https://id.signalwire.com/onboarding) or [Login](https://id.signalwire.com/login/session/new)
3. Complete registration with email and password
4. Verify your email address

<Note>
  If you have problems verifying your account, email [support@signalwire.com](mailto:support@signalwire.com)
</Note>

## Create a Project

After logging in:

1. Navigate to Projects in the dashboard
2. Click "Create New Project"
3. Enter a project name (e.g., "Voice Agents")
4. Select your use case

## Space Name

Your Space Name is your unique SignalWire identifier.

**URL Format:** `https://YOUR-SPACE-NAME.signalwire.com`

**Example:** `https://mycompany.signalwire.com`

**You'll need this for:**

* API authentication
* Dashboard access
* SWML webhook configuration

## API Credentials

Get your API credentials from the project:

1. Go to [API Credentials](https://my.signalwire.com/?page=/credentials)
2. Note your Project ID
3. Create an API Token if needed

| Credential | Format                                       |
| ---------- | -------------------------------------------- |
| Project ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`       |
| API Token  | `PTxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
| Space Name | `your-space`                                 |

<Warning>
  Keep these secure -- don't commit to version control!
</Warning>

## Environment Variables

Set these for your agent. These environment variables are used by all SDK languages:

```bash
export SIGNALWIRE_PROJECT_ID="your-project-id"
export SIGNALWIRE_API_TOKEN="your-api-token"
export SIGNALWIRE_SPACE="your-space.signalwire.com"
```

## Dashboard Overview

| Section                                                             | Purpose                              |
| ------------------------------------------------------------------- | ------------------------------------ |
| **[Phone Numbers](https://my.signalwire.com/?page=/phone_numbers)** | Purchase and manage phone numbers    |
| **[SWML](https://my.signalwire.com/?page=/resources/scripts)**      | Configure SWML scripts and webhooks  |
| **[Logs](https://my.signalwire.com/?page=/logs/voices)**            | View call history and debugging info |
| **[API Credentials](https://my.signalwire.com/?page=/credentials)** | Credentials and API explorer         |
| **[Billing](https://my.signalwire.com/?page=/payment_methods)**     | Account balance and usage            |

## Add Credit

Before making calls:

1. Go to [Billing](https://my.signalwire.com/?page=/payment_methods)
2. Add payment method
3. Add credit to your account

Trial accounts may have limited credit for testing.

## Account Verification

Some features require account verification:

* Phone number purchases
* Outbound calling
* Certain number types

Complete verification in Account Settings if prompted.

## Next Steps

With your account ready:

1. [Purchase a phone number](https://my.signalwire.com/?page=/phone_numbers)
2. Deploy your agent
3. Connect the number to your agent