Dobby Ads

fetch a single invoice by id or invoice number. args: invoiceId (str, optional): the invoice's object id. invoiceNumber (str, optional): the human-readable invoice number. returns: dict: invoice object, or empty dict if not found.

get_invoice

fetch the receipt for a paid invoice using its stripe payment id. args: stripePaymentId (str): stripe payment id from the invoice object. returns: dict: receipt object, or empty dict if not found.

get_invoice_receipt

retrieve invoices with optional filters. args: invoiceIds: filter by specific invoice ids. paymentMode: "offline" or "online". status: "DRAFT", "SCHEDULED", "SENT", "PAID", "REFUND_INITIATED", "REFUND_PENDING", "REFUND_SUCCEEDED", or "REFUND_FAILED". brandId: filter by brand id. returns: list[dict]: invoice objects, each containing: _id, invoiceNumber, status, total, totalAfterDiscount, discount, discountType, brandId, paidAt, isOfflinePayment, invoiceItems, issueDate, lastSentDate, createdAt.

get_invoices

fetch a single order by id or order number. args: orderId (str, optional): the order's object id. orderNumber (str, optional): the human-readable order number. returns: dict: order object, or empty dict if not found.

get_order

list all deliverables attached to an order. args: orderId (str): object id of the order. returns: list[dict]: deliverable objects, each containing: _id, name, serviceId, orderId, taskId, quantity, progress, status ("NOT_STARTED" | "ONGOING" | "APPROVED"), deliverableSets, isPaused, createdAt, updatedAt.

get_order_deliverables

retrieve orders with optional filters. args: brandId: filter by brand id. serviceId: filter by service id. stageId: filter by stage id. tagId: filter by tag id. closed: true → closed orders only. false → open orders only. none → all. limit: max orders to return. defaults to 10. returns: list of order dicts, each containing: _id, title, orderNumber, brandIds, channelId, stageId, tagIds, serviceId, creatorId, lastActivityCreatorRole, lastActivityTime, invoices, closed, createdAt.

get_orders

fetch all roles available for brand assignment. returns: list[dict]: role objects containing _id, name, and permissions.

get_roles

fetch all services for the agency. returns: list[dict]: service objects.

get_services

fetch all brands a user belongs to along with their assigned roles in each brand. args: userId (str): object id of the user. returns: list[dict]: each item contains brandId, brandName, and roles (list of roleId + roleName).

get_user_brand_roles

invite a new user and assign them to one or more brands with roles. args: name (str): full name of the user to invite. email (str): email address of the user to invite. brands (list): list of brand assignments, each containing: brandId (str): id of the brand. roleId (str): id of the role to assign. returns: dict: created user object, or empty dict on failure.

invite_user

request a 30-minute call with the agency. args: message (str): context or notes to help prepare for the meeting. returns: dict: confirmation object, or empty dict on failure.

request_call

send a standard message in a chat channel. args: channelId (str): channel id of the chat (available on the chat object). body (str): message body text. returns: dict: created message object, or empty dict on failure.

send_message_in_chat

send a standard message in an order's channel. args: channelId (str): channel id of the order (available on the order object). body (str): message body text. returns: dict: created message object, or empty dict on failure.

send_message_in_order

update the brand assigned to an order. args: orderId (str): id of the order to update. brandId (str): id of the brand to assign. returns: dict: updated order object, or empty dict on failure.

update_order_brand

update the priority of an order. args: orderId (str): id of the order to update. priority (str): priority level — REGULAR, HIGH, or URGENT. reason (str): reason for the priority change. returns: dict: updated order object, or empty dict on failure.

update_order_priority