# Create Contact — Textlocal

> Create a new contact. See the docs here

- Key: `textlocal-create-contact`
- Type: Action (Write)
- Version: 0.0.2
- App: Textlocal (`textlocal`) — https://pipedream.com/apps/textlocal.md
- This page (HTML): https://pipedream.com/apps/textlocal/actions/create-contact
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/textlocal/actions/create-contact/create-contact.mjs

## Description

Create a new contact. [See the docs here](https://api.txtlocal.com/docs/contactmanagement/createcontacts)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `number` | `string` | Yes | The mobile number in international format (i.e. 447123456789). |
| `firstName` | `string` | No | The first name to be assigned to this contact. |
| `lastName` | `string` | No | The last name to be assigned to this contact. |
| `custom1` | `string` | No | A custom1 to be assigned to this contact. |
| `custom2` | `string` | No | A custom2 to be assigned to this contact. |
| `custom3` | `string` | No | A custom3 to be assigned to this contact. |
| `groupId` | `integer` | Yes | This parameter can be used in place of the numbers parameter in order to send to an entire contact group. This parameter should contain the ID of the relevant group, which can found either within Messenger (in the "Reports" - "Advanced Reports" - "List of Group ID's" section) or by running the get_groups command. Additionally group 5 contains "contacts" and group 6 contains "opt-outs". Options are loaded from the connected account. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "textlocal",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "textlocal-create-contact",
  arguments: {
    number: "Number",
    firstName: "First Name",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "textlocal-create-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    textlocal: { authProvisionId: "apn_xxxxxxx" },
    number: "Number",
    firstName: "First Name",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "textlocal-create-contact",
    "configured_props": {
      "textlocal": { "authProvisionId": "apn_xxxxxxx" },
      "number": "Number",
      "firstName": "First Name"
    }
  }'
```

---

- App: https://pipedream.com/apps/textlocal.md · All apps: https://pipedream.com/apps