Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI
On this page
Looking for more inspiration?Visit the

Test User

Test Users are the contact addresses (e.g. phone numbers, Chat identities) who can test the latest drafts of a Flow even if they aren't yet published.

Update the Test User resource of a Flow to allow the contacts that need to perform tests of unpublished drafts.

TestUser Properties

testuser-properties page anchor
Property nameTypeRequiredPIIDescriptionChild properties
sidSID<FW>

Optional

Not PII

Unique identifier of the flow.

Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34
testUsersarray[string]

Optional

Not PII

List of test user identities that can test draft versions of the flow.

urlstring<uri>

Optional

Not PII

The URL of this resource.

Fetch a TestUser resource

fetch-a-testuser-resource page anchor

GET https://studio.twilio.com/v2/Flows/{Sid}/TestUsers

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
sidSID<FW>
required
Not PII

Unique identifier of the flow.

Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34
Fetch Test UsersLink to code sample: Fetch Test Users
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function fetchTestUser() {

14
  const testUser = await client.studio.v2

15
    .flows("FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")

16
    .testUsers()

17
    .fetch();

18


19
  console.log(testUser.sid);

20
}

21


22
fetchTestUser();

Response

Note about this response
1
{

2
  "sid": "FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

3
  "test_users": [

4
    "user1",

5
    "user2"

6
  ],

7
  "url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TestUsers"

8
}

Update a TestUser resource

update-a-testuser-resource page anchor

POST https://studio.twilio.com/v2/Flows/{Sid}/TestUsers

Each Test User identity can be up to 300 bytes.

Path parameters

path-parameters-1 page anchor
Property nameTypeRequiredPIIDescription
sidSID<FW>
required
Not PII

Unique identifier of the flow.

Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34

Request body parameters

request-body-parameters page anchor
Encoding type:application/x-www-form-urlencoded
SchemaExample
Property nameTypeRequiredPIIDescriptionChild properties
testUsersarray[string]
required
Not PII

List of test user identities that can test draft versions of the flow.

Update Test UsersLink to code sample: Update Test Users
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function updateTestUser() {

14
  const testUser = await client.studio.v2

15
    .flows("FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")

16
    .testUsers()

17
    .update({ testUsers: ["+14155551212", "+14155551213"] });

18


19
  console.log(testUser.sid);

20
}

21


22
updateTestUser();

Response

Note about this response
1
{

2
  "sid": "FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

3
  "test_users": [

4
    "+14155551212",

5
    "+14155551213"

6
  ],

7
  "url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TestUsers"

8
}