diff --git a/Pipedrive/Pipedrive_Add_a_deal.ipynb b/Pipedrive/Pipedrive_Add_a_deal.ipynb new file mode 100644 index 0000000000..41d768bdfe --- /dev/null +++ b/Pipedrive/Pipedrive_Add_a_deal.ipynb @@ -0,0 +1,252 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "7c345a60-a5a2-4b4e-83e8-3fd26b8d7fc5", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "\"Naas.png\"" + ] + }, + { + "cell_type": "markdown", + "id": "4fc0e3f6-2f55-43c3-8dae-7feab09fc725", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "# Pipedrive - Add a deal" + ] + }, + { + "cell_type": "markdown", + "id": "867b0456-5d9a-4bd6-809c-eaa1a7086151", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "**Tags:** #pipedrive #deal #add #api #v1 #python" + ] + }, + { + "cell_type": "markdown", + "id": "ff84e3bb-95cc-41f5-aab0-8c4b00349e6c", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "**Author:** [Florent Ravenel](https://www.linkedin.com/in/florent-ravenel/)" + ] + }, + { + "cell_type": "markdown", + "id": "0a6b2e92-b353-4c61-8461-ad9f3332aa61", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "**Last update:** 2023-12-22 (Created: 2023-12-22)" + ] + }, + { + "cell_type": "markdown", + "id": "05e9fd8b-27dc-4b43-9a67-3b25eda59699", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "**Description:** This notebook adds a new deal. It uses the Pipedrive API v1 to add a deal to the Pipedrive platform." + ] + }, + { + "cell_type": "markdown", + "id": "15336c56-acca-459a-a075-f81a5ab5cdf3", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "**References:**\n- [Pipedrive API v1 - Deals](https://developers.pipedrive.com/docs/api/v1/Deals#addDeal)\n- [Pipedrive API v1 - Authentication](https://developers.pipedrive.com/docs/api/v1/#authentication)" + ] + }, + { + "cell_type": "markdown", + "id": "b394e079-8484-49d0-b00b-e7f3b72a2ef0", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "## Input" + ] + }, + { + "cell_type": "markdown", + "id": "5e69d42d-4223-4c1f-adbe-fceb68813a2d", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "### Import libraries" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "b1b6896f-0f5b-4e1f-be53-3060fa30f069", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": "import requests", + "outputs": [] + }, + { + "cell_type": "markdown", + "id": "133dc409-7a59-4d33-b8e6-172d558fd5d9", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "### Setup variables\n- **api_token**: API token used to authenticate the request. [See how to get an API token](https://developers.pipedrive.com/docs/api/v1/#authentication).\n- **title**: Title of the deal.\n- **value**: Value of the deal." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "e576b493-07a7-4569-a73b-e72f3a9f8ae6", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": "api_token = \"\"\ntitle = \"New deal\"\nvalue = 1000", + "outputs": [] + }, + { + "cell_type": "markdown", + "id": "88290219-023b-4671-9932-3cf769ae0673", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "## Model" + ] + }, + { + "cell_type": "markdown", + "id": "73bc422a-b87b-4ff8-9491-3606f32e759b", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "### Add a deal" + ] + }, + { + "cell_type": "markdown", + "id": "61751a41-7899-42e9-913e-da51562213ab", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "This function adds a new deal to the Pipedrive platform." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "f2472e57-d5d5-4d1c-9111-b472c0baa810", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": "def add_deal(api_token, title, value):\n url = \"https://api.pipedrive.com/v1/deals\"\n headers = {\"Authorization\": \"Bearer \" + api_token}\n data = {\"title\": title, \"value\": value}\n response = requests.post(url, headers=headers, data=data)\n return response", + "outputs": [] + }, + { + "cell_type": "markdown", + "id": "2985a82b-b80b-4825-a8d7-83bf5c41d7ce", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "## Output" + ] + }, + { + "cell_type": "markdown", + "id": "17e3d4a2-d27d-4c47-92e8-23e1c7259440", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + "### Display result" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "f1e4699a-0379-476e-9107-9b4677fb8de6", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": "response = add_deal(api_token, title, value)\nprint(response.json())", + "outputs": [] + }, + { + "cell_type": "markdown", + "id": "e6774dc4-600a-4993-a82e-ee2556a04a94", + "metadata": { + "papermill": {}, + "tags": [] + }, + "source": [ + " " + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.6" + }, + "widgets": { + "application/vnd.jupyter.widget-state+json": { + "state": {}, + "version_major": 2, + "version_minor": 0 + } + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} \ No newline at end of file