> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedrive: Add Organization

> Create an organization in Pipedrive with its name, owner, address, website and industry. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Create an organization in Pipedrive with its name, owner, address, website and industry.

> [!NOTE]
>
> Tool ID: `pipedrive_add_organization`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'pipedrive_add_organization',
  {
    "name": "Example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute pipedrive_add_organization --input '{
  "name": "Example"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "success": true,
    "data": {
      "id": 123,
      "name": "Example",
      "owner_id": 123
    }
  }
}
```

Use `deepline describe pipedrive_add_organization --json` for the latest machine-readable contract.

## Input reference

Adds a new organization.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.name` | `string` | Yes | — | The name of the organization |
| `payload.owner_id` | `integer` | No | — | The ID of the user who owns the organization |
| `payload.add_time` | `string` | No | — | The creation date and time of the organization |
| `payload.visible_to` | `integer` | No | — | The visibility of the organization |
| `payload.label_ids` | `array` | No | — | The IDs of labels assigned to the organization |
| `payload.address` | `object` | No | — | The address of the organization |
| `payload.website` | `string` | No | — | The website of the organization |
| `payload.linkedin` | `string` | No | — | The LinkedIn profile URL of the organization |
| `payload.industry` | `integer` | No | — | The industry the organization belongs to |
| `payload.annual_revenue` | `integer` | No | — | The annual revenue of the organization |
| `payload.employee_count` | `integer` | No | — | The number of employees in the organization |
| `payload.custom_fields` | `object` | No | — | An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes. To clear a custom field value, set it to `null`. For multi-option fields (field type `set`), use `null` to clear the selection — sending an empty array `[]` is not supported and will result in a validation error. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Adds a new organization.",
    "properties": {
      "name": {
        "type": "string",
        "description": "The name of the organization"
      },
      "owner_id": {
        "type": "integer",
        "description": "The ID of the user who owns the organization"
      },
      "add_time": {
        "type": "string",
        "description": "The creation date and time of the organization"
      },
      "visible_to": {
        "type": "integer",
        "description": "The visibility of the organization"
      },
      "label_ids": {
        "type": "array",
        "description": "The IDs of labels assigned to the organization",
        "items": {
          "type": "integer"
        }
      },
      "address": {
        "type": "object",
        "description": "The address of the organization",
        "properties": {
          "value": {
            "type": "string",
            "description": "The full address of the organization"
          },
          "country": {
            "type": "string",
            "description": "Country of the organization"
          },
          "admin_area_level_1": {
            "type": "string",
            "description": "Admin area level 1 (e.g. state) of the organization"
          },
          "admin_area_level_2": {
            "type": "string",
            "description": "Admin area level 2 (e.g. county) of the organization"
          },
          "locality": {
            "type": "string",
            "description": "Locality (e.g. city) of the organization"
          },
          "sublocality": {
            "type": "string",
            "description": "Sublocality (e.g. neighborhood) of the organization"
          },
          "route": {
            "type": "string",
            "description": "Route (e.g. street) of the organization"
          },
          "street_number": {
            "type": "string",
            "description": "Street number of the organization"
          },
          "subpremise": {
            "type": "string",
            "description": "Subpremise (e.g. apartment/suite number) of the organization"
          },
          "postal_code": {
            "type": "string",
            "description": "Postal code of the organization"
          }
        },
        "additionalProperties": false
      },
      "website": {
        "type": [
          "string",
          "null"
        ],
        "description": "The website of the organization"
      },
      "linkedin": {
        "type": [
          "string",
          "null"
        ],
        "description": "The LinkedIn profile URL of the organization"
      },
      "industry": {
        "type": [
          "integer",
          "null"
        ],
        "description": "The industry the organization belongs to"
      },
      "annual_revenue": {
        "type": [
          "integer",
          "null"
        ],
        "description": "The annual revenue of the organization"
      },
      "employee_count": {
        "type": [
          "integer",
          "null"
        ],
        "description": "The number of employees in the organization"
      },
      "custom_fields": {
        "type": "object",
        "description": "An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes. To clear a custom field value, set it to `null`. For multi-option fields (field type `set`), use `null` to clear the selection — sending an empty array `[]` is not supported and will result in a validation error.",
        "additionalProperties": true
      }
    },
    "required": [
      "name"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.success` | `boolean` | No | — | If the response is successful or not |
| `result.data.data` | `object` | No | — | — |
| `result.data.data.id` | `integer` | No | — | The ID of the organization |
| `result.data.data.name` | `string` | No | — | The name of the organization |
| `result.data.data.owner_id` | `integer` | No | — | The ID of the user who owns the organization |
| `result.data.data.add_time` | `string` | No | — | The creation date and time of the organization |
| `result.data.data.update_time` | `string` | No | — | The last updated date and time of the organization |
| `result.data.data.is_deleted` | `boolean` | No | — | Whether the organization is deleted or not |
| `result.data.data.visible_to` | `integer` | No | — | The visibility of the organization |
| `result.data.data.address` | `object` | No | — | The address of the organization |
| `result.data.data.address.value` | `string` | No | — | The full address of the organization |
| `result.data.data.address.country` | `string` | No | — | Country of the organization |
| `result.data.data.address.admin_area_level_1` | `string` | No | — | Admin area level 1 (e.g. state) of the organization |
| `result.data.data.address.admin_area_level_2` | `string` | No | — | Admin area level 2 (e.g. county) of the organization |
| `result.data.data.address.locality` | `string` | No | — | Locality (e.g. city) of the organization |
| `result.data.data.address.sublocality` | `string` | No | — | Sublocality (e.g. neighborhood) of the organization |
| `result.data.data.address.route` | `string` | No | — | Route (e.g. street) of the organization |
| `result.data.data.address.street_number` | `string` | No | — | Street number of the organization |
| `result.data.data.address.subpremise` | `string` | No | — | Subpremise (e.g. apartment/suite number) of the organization |
| `result.data.data.address.postal_code` | `string` | No | — | Postal code of the organization |
| `result.data.data.label_ids` | `array` | No | — | The IDs of labels assigned to the organization |
| `result.data.data.website` | `string \| null` | No | — | The website of the organization |
| `result.data.data.linkedin` | `string \| null` | No | — | The LinkedIn profile URL of the organization |
| `result.data.data.industry` | `integer \| null` | No | — | The industry the organization belongs to |
| `result.data.data.annual_revenue` | `integer \| null` | No | — | The annual revenue of the organization |
| `result.data.data.employee_count` | `integer \| null` | No | — | The number of employees in the organization |
| `result.data.data.custom_fields` | `record` | No | — | An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes. To clear a custom field value, set it to `null`. For multi-option fields (field type `set`), use `null` to clear the selection — sending an empty array `[]` is not supported and will result in a validation error. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "If the response is successful or not"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "description": "The ID of the organization"
              },
              "name": {
                "type": "string",
                "description": "The name of the organization"
              },
              "owner_id": {
                "type": "integer",
                "description": "The ID of the user who owns the organization"
              },
              "add_time": {
                "type": "string",
                "description": "The creation date and time of the organization"
              },
              "update_time": {
                "type": "string",
                "description": "The last updated date and time of the organization"
              },
              "is_deleted": {
                "type": "boolean",
                "description": "Whether the organization is deleted or not"
              },
              "visible_to": {
                "type": "integer",
                "description": "The visibility of the organization"
              },
              "address": {
                "type": "object",
                "description": "The address of the organization",
                "properties": {
                  "value": {
                    "type": "string",
                    "description": "The full address of the organization"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country of the organization"
                  },
                  "admin_area_level_1": {
                    "type": "string",
                    "description": "Admin area level 1 (e.g. state) of the organization"
                  },
                  "admin_area_level_2": {
                    "type": "string",
                    "description": "Admin area level 2 (e.g. county) of the organization"
                  },
                  "locality": {
                    "type": "string",
                    "description": "Locality (e.g. city) of the organization"
                  },
                  "sublocality": {
                    "type": "string",
                    "description": "Sublocality (e.g. neighborhood) of the organization"
                  },
                  "route": {
                    "type": "string",
                    "description": "Route (e.g. street) of the organization"
                  },
                  "street_number": {
                    "type": "string",
                    "description": "Street number of the organization"
                  },
                  "subpremise": {
                    "type": "string",
                    "description": "Subpremise (e.g. apartment/suite number) of the organization"
                  },
                  "postal_code": {
                    "type": "string",
                    "description": "Postal code of the organization"
                  }
                },
                "additionalProperties": false
              },
              "label_ids": {
                "type": "array",
                "description": "The IDs of labels assigned to the organization",
                "items": {
                  "type": "integer"
                }
              },
              "website": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The website of the organization"
              },
              "linkedin": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The LinkedIn profile URL of the organization"
              },
              "industry": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "The industry the organization belongs to"
              },
              "annual_revenue": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "The annual revenue of the organization"
              },
              "employee_count": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "The number of employees in the organization"
              },
              "custom_fields": {
                "type": "object",
                "description": "An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes. To clear a custom field value, set it to `null`. For multi-option fields (field type `set`), use `null` to clear the selection — sending an empty array `[]` is not supported and will result in a validation error.",
                "additionalProperties": true
              }
            },
            "additionalProperties": false
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Pipedrive provider guide](https://deepline.com/docs/providers/pipedrive/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.