View as Markdown
Fibery icon

Fibery ACTION

Get or Create Entity

Get an entity or create one if it doesn't exist. See the docs here
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Fibery account once, then configure and run Get or Create Entity from your backend or agent.

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)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get or Create Entity inputs
Property Type Description
type Type string
A custom type in your Fibery account
Required Dynamic
where Where string
A list of expressions to filter the results. See docs here. E.g. [ "=", [ "Development/name" ], "$pipedream" ]
Optional
params Params object
The params to pass with the where query. E.g. { "$pipedream": "pipedream" }
Optional
fields Fields string[]
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"]}]
Optional Dynamic
attributes Attributes object
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
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
fibery-get-entity-or-create
Version
0.0.2
App
Fibery
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes