Daisychain
==========

********
Overview
********

`Daisychain <https://www.daisychain.app/>`_ is a digital organizing automation tool that allows organizers to string together automated digital outreach steps, similar to Zapier but designed specifically for digital organizing. The Parsons connector provides methods for finding contacts and triggering events through the Daisychain API.

This connector implements the ``people/match`` and ``actions`` endpoints of the Daisychain API, allowing you to find existing people records and post actions that can trigger automations.

.. note::
  Authentication
    The Daisychain API uses API token authentication. You can generate your API token from your Daisychain account settings.

***********
Quick Start
***********

To instantiate the class, you can either pass in the API token as an argument or set the ``DAISYCHAIN_API_TOKEN`` environmental variable.

.. code-block:: python

   from parsons import Daisychain

   # First approach: Use API credentials via environmental variables
   dc = Daisychain()

   # Second approach: Pass API credentials as arguments
   dc = Daisychain(api_token='MY_API_TOKEN')

You can then call various endpoints:

.. code-block:: python

    # Find a person by email address
    people = dc.find_person(email_address='person@example.com')

    # Find a person by phone number
    people = dc.find_person(phone_number='+15555551234')

    # Find a person by email and phone (AND logic)
    people = dc.find_person(email_address='person@example.com', phone_number='+15555551234')

    # Post an action to trigger an automation
    # This will create a new person if they don't exist, or associate the action with an existing person
    person_id = dc.post_action(
        email_address='person@example.com',
        phone_number='+15555551234',
        first_name='Jane',
        last_name='Doe',
        email_opt_in=True,
        sms_opt_in=True,
        action_data={'type': 'petition_signature', 'petition_id': '12345'}
    )

    # Use action_data with custom fields to trigger specific automations
    # The action_data can contain any JSON and be matched in Daisychain automation builder
    person_id = dc.post_action(
        email_address='volunteer@example.com',
        action_data={'event_type': 'volunteer_signup', 'event_id': 'canvass_2024'}
    )

***
API
***
.. autoclass :: parsons.Daisychain
   :inherited-members: