# listmonk > Listmonk Email API Client for Python ## Docs ### API Reference #### Configuration & Authentication > Point the client at your Listmonk instance and authenticate. - [set_url_base](https://mkennedy.codes/docs/listmonk/reference/set_url_base.html): Set the base URL of your Listmonk instance for all subsequent calls - [get_base_url](https://mkennedy.codes/docs/listmonk/reference/get_base_url.html): Return the configured base URL of your Listmonk instance - [login](https://mkennedy.codes/docs/listmonk/reference/login.html): Log into Listmonk and cache the credentials for the life of your app - [verify_login](https://mkennedy.codes/docs/listmonk/reference/verify_login.html): Verify that the stored login credentials are still valid at the server - [is_healthy](https://mkennedy.codes/docs/listmonk/reference/is_healthy.html): Check whether the server is reachable and the stored credentials are valid #### Mailing Lists > Read and manage mailing lists. - [lists](https://mkennedy.codes/docs/listmonk/reference/lists.html): Get all mailing lists on the server - [list_by_id](https://mkennedy.codes/docs/listmonk/reference/list_by_id.html): Get the full details of a single mailing list by its ID - [create_list](https://mkennedy.codes/docs/listmonk/reference/create_list.html): Create a new mailing list on the server - [update_list](https://mkennedy.codes/docs/listmonk/reference/update_list.html): Update an existing mailing list on the server - [delete_list](https://mkennedy.codes/docs/listmonk/reference/delete_list.html): Delete a mailing list by its ID #### Subscribers > Create, query, update, and manage the status of subscribers. - [subscribers](https://mkennedy.codes/docs/listmonk/reference/subscribers.html): Get the list of subscribers matching the given criteria, or all subscribers if no criteria are given - [subscriber_by_email](https://mkennedy.codes/docs/listmonk/reference/subscriber_by_email.html): Retrieve a single subscriber by their email address (e.g. "some_user@talkpython.fm") - [subscriber_by_id](https://mkennedy.codes/docs/listmonk/reference/subscriber_by_id.html): Retrieve a single subscriber by their numeric Listmonk ID (e.g. 201) - [subscriber_by_uuid](https://mkennedy.codes/docs/listmonk/reference/subscriber_by_uuid.html): Retrieve a single subscriber by their UUID (e.g. "c37786af-e6ab-4260-9b49-740adpcm6ed") - [create_subscriber](https://mkennedy.codes/docs/listmonk/reference/create_subscriber.html): Create a new subscriber on the Listmonk server - [update_subscriber](https://mkennedy.codes/docs/listmonk/reference/update_subscriber.html): Update many aspects of a subscriber: email and name, custom attribute data, list membership, and status - [add_subscribers_to_lists](https://mkennedy.codes/docs/listmonk/reference/add_subscribers_to_lists.html): Add a number of subscribers to a number of lists in a single bulk operation - [enable_subscriber](https://mkennedy.codes/docs/listmonk/reference/enable_subscriber.html): Set a subscriber's status to enabled so they will receive campaigns - [disable_subscriber](https://mkennedy.codes/docs/listmonk/reference/disable_subscriber.html): Set a subscriber's status to disabled, pausing their subscription so they will not receive campaigns - [block_subscriber](https://mkennedy.codes/docs/listmonk/reference/block_subscriber.html): Add a subscriber to the blocklist, effectively unsubscribing them so they will not receive any mail - [confirm_optin](https://mkennedy.codes/docs/listmonk/reference/confirm_optin.html): Confirm a subscriber's opt-in to a list via the API - [delete_subscriber](https://mkennedy.codes/docs/listmonk/reference/delete_subscriber.html): Completely delete a subscriber from your system (as if they were never there) #### Campaigns > Create, preview, update, and delete email campaigns. - [campaigns](https://mkennedy.codes/docs/listmonk/reference/campaigns.html): Get all campaigns on the server - [campaign_by_id](https://mkennedy.codes/docs/listmonk/reference/campaign_by_id.html): Get the full details of a campaign with the given ID - [campaign_preview_by_id](https://mkennedy.codes/docs/listmonk/reference/campaign_preview_by_id.html): Get the rendered preview of a campaign with the given ID - [create_campaign](https://mkennedy.codes/docs/listmonk/reference/create_campaign.html): Create a new campaign with the given parameters - [update_campaign](https://mkennedy.codes/docs/listmonk/reference/update_campaign.html): Update an existing campaign with the provided campaign information - [delete_campaign](https://mkennedy.codes/docs/listmonk/reference/delete_campaign.html): Completely delete a campaign from your system #### Templates > Manage email templates and set the default. - [templates](https://mkennedy.codes/docs/listmonk/reference/templates.html): Retrieve all templates defined on the Listmonk instance - [template_by_id](https://mkennedy.codes/docs/listmonk/reference/template_by_id.html): Retrieve a single template by its numeric ID - [template_preview_by_id](https://mkennedy.codes/docs/listmonk/reference/template_preview_by_id.html): Render and return a preview of a template - [create_template](https://mkennedy.codes/docs/listmonk/reference/create_template.html): Create a new template on the Listmonk instance - [update_template](https://mkennedy.codes/docs/listmonk/reference/update_template.html): Update an existing template on the Listmonk instance - [set_default_template](https://mkennedy.codes/docs/listmonk/reference/set_default_template.html): Mark the given template as the default for its type - [delete_template](https://mkennedy.codes/docs/listmonk/reference/delete_template.html): Permanently delete a template from the Listmonk instance #### Transactional Email > Send one-off transactional messages. - [send_transactional_email](https://mkennedy.codes/docs/listmonk/reference/send_transactional_email.html): Send a transactional email through Listmonk to a single recipient #### Data Models > Pydantic models returned by and passed to the API functions. - [models.MailingList](https://mkennedy.codes/docs/listmonk/reference/models.MailingList.html) - [models.SubscriberStatus](https://mkennedy.codes/docs/listmonk/reference/models.SubscriberStatus.html) - [models.SubscriberStatuses](https://mkennedy.codes/docs/listmonk/reference/models.SubscriberStatuses.html) - [models.Subscriber](https://mkennedy.codes/docs/listmonk/reference/models.Subscriber.html) - [models.CreateSubscriberModel](https://mkennedy.codes/docs/listmonk/reference/models.CreateSubscriberModel.html) - [models.Campaign](https://mkennedy.codes/docs/listmonk/reference/models.Campaign.html) - [models.CreateCampaignModel](https://mkennedy.codes/docs/listmonk/reference/models.CreateCampaignModel.html) - [models.UpdateCampaignModel](https://mkennedy.codes/docs/listmonk/reference/models.UpdateCampaignModel.html) - [models.CampaignPreview](https://mkennedy.codes/docs/listmonk/reference/models.CampaignPreview.html) - [models.Template](https://mkennedy.codes/docs/listmonk/reference/models.Template.html) - [models.CreateTemplateModel](https://mkennedy.codes/docs/listmonk/reference/models.CreateTemplateModel.html) - [models.TemplatePreview](https://mkennedy.codes/docs/listmonk/reference/models.TemplatePreview.html) #### Exceptions > Errors raised by the client. - [errors.ValidationError](https://mkennedy.codes/docs/listmonk/reference/errors.ValidationError.html) - [errors.OperationNotAllowedError](https://mkennedy.codes/docs/listmonk/reference/errors.OperationNotAllowedError.html) - [errors.ListmonkFileNotFoundError](https://mkennedy.codes/docs/listmonk/reference/errors.ListmonkFileNotFoundError.html)