Pylon

Pylon integration (Communication, Productivity). Imported from open-connector.

API key13 toolshttps://api.usepylon.com

GET

pylon_get_me

Fetch the Pylon organization associated with the API token.

/me

GET

pylon_list_issues

List Pylon issues within a required time range of up to 30 days.

/issues

4 parameters

Param	Type	Required	Description
start_time	string	required	The start time of the issue range in RFC3339 format.
end_time	string	required	The end time of the issue range in RFC3339 format.
cursor	string	optional	The pagination cursor returned by a previous Pylon request.
limit	integer	optional	The number of issues to fetch. Pylon accepts 0 through 20000.

GET

pylon_get_issue

Fetch one Pylon issue by ID or issue number.

/issues/{id}

1 parameter

Param	Type	Required	Description
id	string	required	The Pylon issue ID or issue number.

POST

pylon_create_issue

Create a Pylon issue with a title, HTML body, and requester or account context.

/issues

18 parameters

Param	Type	Required	Description
title	string	required	The issue title.
body_html	string	required	The HTML content of the issue body.
account_id	string	optional	The account this issue belongs to.
requester_id	string	optional	The contact this issue is on behalf of.
requester_email	string	optional	The requester email address. Pylon creates a contact when none exists.
requester_name	string	optional	The full name to use when creating a requester contact.
requester_avatar_url	string	optional	The requester avatar URL.
user_id	string	optional	The internal user to attribute the first message to.
contact_id	string	optional	The contact to attribute the first message to.
assignee_id	string	optional	The user the issue should be assigned to.
team_id	string	optional	The team the issue should be assigned to.
priority	string	optional	The issue priority.
tags	array	optional	Tags to set on the Pylon object.
attachment_urls	array	optional	Publicly reachable attachment URLs for Pylon to fetch and attach.
author_unverified	boolean	optional	Whether the requester's identity has not been verified.
created_at	string	optional	The issue creation timestamp in RFC3339 format.
custom_fields	array	optional	Custom field values to apply to the Pylon object.
destination_metadata	object	optional	Delivery metadata for a newly created Pylon issue.

PATCH

pylon_update_issue

Update mutable fields on one Pylon issue by ID or issue number.

/issues/{id}

11 parameters

Param	Type	Required	Description
id	string	required	The Pylon issue ID or issue number.
title	string	optional	The updated issue title.
state	string	optional	The new issue state or custom status slug.
type	string	optional	The updated issue type.
account_id	string	optional	The account this issue belongs to.
requester_id	string	optional	The contact this issue is on behalf of.
assignee_id	string	optional	The user to assign this issue to. Use an empty string to remove the assignee.
team_id	string	optional	The team to assign this issue to. Use an empty string to remove the team.
customer_portal_visible	boolean	optional	Whether the issue should be visible in the customer portal.
tags	array	optional	Tags to set on the Pylon object.
custom_fields	array	optional	Custom field values to apply to the Pylon object.

GET

pylon_list_issue_messages

List messages, replies, and internal notes on one Pylon issue.

/issues/{id}/messages

3 parameters

Param	Type	Required	Description
id	string	required	The Pylon issue ID.
cursor	string	optional	The pagination cursor returned by a previous Pylon request.
limit	integer	optional	The number of messages to fetch. Pylon accepts values from 1 through 1000.

POST

pylon_create_issue_note

Create an internal note on a Pylon issue.

/issues/{id}/note

7 parameters

Param	Type	Required	Description
id	string	required	The Pylon issue ID.
body_html	string	required	The HTML body of the internal note.
attachment_urls	array	optional	Publicly reachable attachment URLs for Pylon to fetch and attach.
message_id	string	optional	The internal note message ID to reply to.
thread_id	string	optional	The internal thread ID to post the note to.
thread_name	string	optional	The thread name to use if Pylon creates a new internal thread.
user_id	string	optional	The internal user ID to post the note as.

GET

pylon_get_account

Fetch one Pylon account by account ID or external ID.

/accounts/{id}

1 parameter

Param	Type	Required	Description
id	string	required	The Pylon account ID or external ID.

POST

pylon_search_accounts

Search Pylon accounts with a filter and optional fuzzy text search.

/accounts/search

4 parameters

Param	Type	Required	Description
filter	object	required	A Pylon search filter object.
search_text	string	optional	Fuzzy text search intersected with the provided account filter.
cursor	string	optional	The pagination cursor returned by a previous Pylon request.
limit	integer	optional	The number of accounts to fetch. Pylon accepts values from 1 through 999.

POST

pylon_create_account

Create a Pylon account.

/accounts

9 parameters

Param	Type	Required	Description
name	string	required	The account name.
account_type	string	optional	The account type.
domains	array	optional	Domains for the account, without a leading scheme.
primary_domain	string	optional	The primary domain, which must be included in domains when domains are provided.
external_ids	array	optional	External IDs associated with the object.
tags	array	optional	Tags to set on the Pylon object.
owner_id	string	optional	The user ID of the account owner.
logo_url	string	optional	The square .png, .jpg, or .jpeg logo URL for the account.
custom_fields	array	optional	Custom field values to apply to the Pylon object.

GET

pylon_get_contact

Fetch one Pylon contact by contact ID with optional paginated account context.

/contacts/{id}

3 parameters

Param	Type	Required	Description
id	string	required	The Pylon contact ID.
cursor	string	optional	The pagination cursor returned by a previous Pylon request.
limit	integer	required	The number of related accounts to fetch. Pylon requires this query value and ac…

POST

pylon_search_contacts

Search Pylon contacts with a filter and optional fuzzy text search.

/contacts/search

4 parameters

Param	Type	Required	Description
filter	object	required	A Pylon search filter object.
search_text	string	optional	Fuzzy text search intersected with the provided contact filter.
cursor	string	optional	The pagination cursor returned by a previous Pylon request.
limit	integer	optional	The number of contacts to fetch. Pylon accepts values from 1 through 999.

POST

pylon_create_contact

Create a Pylon contact.

/contacts

11 parameters

Param	Type	Required	Description
name	string	required	The contact name.
email	string	optional	The contact email address.
account_id	string	optional	The account that this contact belongs to.
account_external_id	string	optional	The external ID of the account that this contact belongs to.
avatar_url	string	optional	The square .png, .jpg, or .jpeg avatar URL for the contact.
external_ids	array	optional	External IDs associated with the object.
phone_numbers	array	optional	Phone numbers for the contact. Pylon expects digits only and at most 15 digits.
primary_phone_number	string	optional	The primary phone number, which must be in phone_numbers.
portal_role	string	optional	The portal role slug to assign to the contact.
portal_role_id	string	optional	The custom portal role ID to assign to the contact.
custom_fields	array	optional	Custom field values to apply to the Pylon object.