# Create Player — Pointagram

> Create a new player. See the docs here

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

## Description

Create a new player. [See the docs here](https://www.pointagram.com/custom-integration-gamification/)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `name` | `string` | Yes | The name of the player in Pointagram |
| `email` | `string` | Yes | The email address of the player. Used for sending invitation |
| `externalId` | `string` | No | Optional id you can provide as an unique identifier for the player. |
| `offline` | `boolean` | No | Set true for offline or false for online player. An online player will receive an invitation to log on to Pointagram. Note, you can create players as offline players and convert them later in Pointagram. |

## 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": "pointagram",
      },
    },
  },
)

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: "pointagram-create-player",
  arguments: {
    name: "Name",
    email: "Email",
  },
})
```

**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: "pointagram-create-player",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pointagram: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    email: "Email",
  },
})

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": "pointagram-create-player",
    "configured_props": {
      "pointagram": { "authProvisionId": "apn_xxxxxxx" },
      "name": "Name",
      "email": "Email"
    }
  }'
```

---

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