# Get or Create Entity — Fibery

> Get an entity or create one if it doesn't exist. See the docs here

- Key: `fibery-get-entity-or-create`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Fibery (`fibery`) — https://pipedream.com/apps/fibery.md
- This page (HTML): https://pipedream.com/apps/fibery/actions/get-entity-or-create
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/fibery/actions/get-entity-or-create/get-entity-or-create.mjs

## Description

Get an entity or create one if it doesn't exist. [See the docs here](https://api.fibery.io/graphql.html#create)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `type` | `string` | Yes | A custom type in your Fibery account Options are loaded from the connected account. |
| `where` | `string` | No | A list of expressions to filter the results. See docs here. E.g. [ "=", [ "Development/name" ], "$pipedream" ] |
| `params` | `object` | No | The params to pass with the where query. E.g. { "$pipedream": "pipedream" } |
| `fields` | `string[]` | No | The select fields for an entity type. This prop is an array of strings. Each string should have the same structure as in the docs E.g. ["fibery/id",{"Development/Team":["fibery/id"]}] Options are loaded from the connected account. |
| `attributes` | `object` | Yes | The attributes of the entity to create. This prop is a JSON object, where each key is the name of the attribute, and each value is the value to set for the field. You can use the List Fields for Entity Type action to get the list of available fields |

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

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: "fibery-get-entity-or-create",
  arguments: {
    type: "Type",
    where: "Where",
  },
})
```

**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: "fibery-get-entity-or-create",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    fibery: { authProvisionId: "apn_xxxxxxx" },
    type: "Type",
    where: "Where",
  },
})

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": "fibery-get-entity-or-create",
    "configured_props": {
      "fibery": { "authProvisionId": "apn_xxxxxxx" },
      "type": "Type",
      "where": "Where"
    }
  }'
```

---

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